修好它，然后发出去

报错不是失败，是信息

新手看到满屏红字的第一反应是慌。但报错其实是这个系统里最友好的部分——它明确告诉你哪个文件、第几行、出了什么问题。真正麻烦的是没有报错但结果不对。

三个找线索的地方：

1. 浏览器控制台 —— 按 F12，切到 Console。红色的是错误。
2. 终端 —— 命令跑失败时，报错就在你输命令的下方。
3. Network 面板 —— 如果是数据没来，看这里哪条请求是红的。

怎么把问题描述给 AI

对比一下：

❌ 它坏了，帮我修

✅ 点击提交按钮后页面没反应。控制台报错：
Uncaught TypeError: Cannot read properties of null (reading 'addEventListener')
at app.js:14

我预期点击后会弹出提示框。

好的 bug 描述包含三件事：做了什么操作 → 期望什么 → 实际发生什么（附完整报错）。

课堂练习：调试侦探

打开你的项目，随便挑一处故意弄坏——删掉一个字符、改错一个名字。刷新，看报错。

然后不许看代码，只用自然语言让 AI 找出问题所在。

这个练习的意义在于：你会发现自己即使读不懂代码，也完全有能力主导排查过程。你负责观察和描述，AI 负责翻译和修复。

存档：把 Git 用起来

git init
git add .
git commit -m "完成个人页面，含深色模式"

从现在起，每当项目处于能跑的状态，就提交一次。做一次危险的大改之前，先提交。改砸了，一条命令回到刚才：

git restore .

这条安全网让你敢于让 AI 大刀阔斧地试。

发出去

推到 GitHub，开启 Pages（步骤见工具与环境）。等一分钟，你会得到一个网址。

把它发给一个朋友。

这是这门课第一个真正的分水岭——在此之前你在自己电脑上做东西，在此之后你的作品活在互联网上，任何人都能访问。

顺手做一件事

让 AI 生成一份项目说明：

帮我在项目根目录写一个 AGENTS.md，
说明这个项目的结构、用了什么技术、每个文件负责什么。
以后你或别的 AI 打开这个项目时先读它。

项目越大，这个文件越值钱。