看懂 AI 改了什么：用 git 管住改动

想象这样的场景：番茄钟已经能用了，你让智能体再加一个「统计今日完成数」。它改了三个文件，页面却坏了。你想退回到刚才好用的版本，可是……刚才的版本在哪里？

如果没有存档，答案是「没了」。你只能指望它记得自己改过什么，然后让它反着改一遍，而它改的时候又可能引入新问题。

这一课解决的就是这件事：给你的项目装一个「存档」系统，让智能体怎么折腾，你都能看清、能退回。 这个系统叫 git。别被它的名声吓到：入门只需要七八条命令，而且大多数时候你可以让智能体替你敲。

为什么必须配合 git

用智能体写代码，有三个现实：

1. 它改得很快、很多。 你很难凭记忆知道它动了哪些文件。
2. 它会犯错。 有时是小错，有时是把没问题的地方也「顺手优化」坏了。
3. 你需要随时能退。 越敢放手让它试，越需要一个安全网。

git 能给你的是：每次改动都留下可对比、可恢复的记录。

Claude Code 自己也有回退能力（后面会讲），但官方文档明确说明它不能替代 git：它主要是为了在一次会话里快速撤销，而 git 才是长期的版本历史。两者配合使用最稳妥。

先装好 git

在终端里运行：

git --version

能看到版本号就已经装好了。没装的话：

• macOS：运行 git --version，系统会弹窗提示安装「命令行开发者工具」，按提示安装；
• Windows：去 git-scm.com/downloads/win 下载 Git for Windows，安装时一路下一步（也是第 3 课推荐的）；
• Linux：Debian、Ubuntu 用 sudo apt install git-all，Fedora 用 sudo dnf install git-all。

第一次使用，要告诉 git 你是谁，每台电脑只需做一次。把引号里换成你自己的名字和邮箱：

git config --global user.name "你的名字"
git config --global user.email "you@example.com"

每个提交都会记录这两项，所以要填你愿意留在记录里的信息。

最小 git：七条命令

用上一课的 pomodoro 文件夹来练习。下面的操作都在终端里，先 cd 进入这个文件夹。

做第一个存档

$ git init
  Initialized empty Git repository in .../pomodoro/.git/
$ git status
  Untracked files:
    app.js  index.html  style.css
$ git add .
$ git commit -m "完成番茄钟基础版：开始、暂停、重置、阶段切换"
  3 files changed, 142 insertions(+)
$ git log --oneline
  a1b2c3d 完成番茄钟基础版：开始、暂停、重置、阶段切换

这里 git add . 中的点号表示「当前文件夹里所有改动」。a1b2c3d 是这个存档的编号（你的会不一样），后面回退时会用到。

看懂 git diff

假设你让智能体加了「今日完成数」，改完后在终端里运行 git diff，会看到类似这样的内容：

diff --git a/app.js b/app.js
--- a/app.js
+++ b/app.js
@@ -12,6 +12,9 @@ const BREAK_MINUTES = 5;
 let mode = 'focus';
 let remaining = FOCUS_MINUTES * 60;
+let doneToday = Number(localStorage.getItem('doneToday') || 0);
+
 function render() {
-  timeEl.textContent = format(remaining);
+  timeEl.textContent = format(remaining);
+  countEl.textContent = '今日完成：' + doneToday;
 }

读法很简单，不需要懂编程：

• --- 是旧版本，+++ 是新版本，涉及的文件名在这两行里；
• 以 + 开头、通常显示为绿色的行是新增的，以 - 开头、红色的行是删除的；
• 没有符号的行是上下文，帮你定位；
• @@ 开头那一行告诉你这是文件的第几行附近。

你不必理解每一行代码，但要能回答三个问题：改了哪几个文件？大概改了多少？有没有改到我没让它碰的东西？最后一个问题最重要，如果它在改「完成数」时顺便动了计时核心逻辑，你应该起疑。

在 Claude Code 里，你也可以直接输入 /diff，不离开会话就能看到工作区的所有改动，包括它刚刚改的。

另外，git diff 默认只显示还没 add 的改动。已经 add 但没提交的，用 git diff --staged 看。

回滚的三种场景

场景 1：改了还没提交，想丢掉对某个文件的修改。

git restore app.js

这会让 app.js 回到上一次存档时的样子。注意：未提交的改动会被直接丢弃，通常无法找回，所以先用 git status 和 git diff 确认你要丢掉的就是这些。

场景 2：想把某个文件恢复到更早的某个存档。 先用 git log --oneline 找到编号，然后：

git restore --source=a1b2c3d app.js

场景 3：已经提交了，才发现这次提交不对。

git revert HEAD

它不会删除历史，而是新建一个提交，把上一个提交的改动反着做一遍。因为历史完整保留，这是最安全的撤销方式。执行时需要工作区没有未提交的改动。想不打开编辑器直接用默认说明，可以加 --no-edit。

让智能体帮你提交

这些命令你知道有它们就好，日常大部分时间，你可以直接让 Claude Code 做。官方快速入门里就给了现成的说法：让它看看改了哪些文件，再用有描述性的信息提交。

它在执行 git commit 时，手动模式下会请求你的许可，这是个很好的最后检查点。养成习惯：

1. 提交前，自己扫一眼它总结的改动清单；
2. 提交后，看一眼 git log --oneline，确认提交说明写得对，不夸大也不遗漏。

好的提交信息，是未来的你（或者另一个智能体）读历史时的路标。比较两种写法：

Claude Code 自带的回退：/rewind

Claude Code 在你发每条消息之前，会自动记录它用文件编辑工具要改的文件状态（官方称为检查点，checkpoint）。当智能体走偏了，你有两种办法回退：

• 在输入框为空时连按两次 Esc；
• 或输入 /rewind。

它会列出你在这次会话里发过的消息，选中一个时间点后，可以选择：

• 恢复代码和对话：两者都退回那个点；
• 只恢复对话：代码保持现状；
• 只恢复代码：对话保留，文件退回；
• 从这里开始总结：压缩对话，释放上下文空间（与回退代码无关）。

官方文档里写明了它的边界，你要记住，因为这正是 git 要接手的地方：

• 通过 Bash 命令（比如它运行 rm 或 sed）改动的、而之前没用文件编辑工具改过的文件，不会被跟踪；
• 你自己在编辑器里手动改的内容、别的会话里的改动，通常不会被捕获；
• 部分子智能体的改动不会被恢复；
• 检查点会过期清理（默认大约 30 天后）。

所以分工是这样的：

一个实用的比方：/rewind 像编辑器里的「撤销」，git 像「另存为一个版本」。

把它变成习惯：每完成一小步就提交

最值钱的一个习惯：

每完成一个可以独立验证的小步骤，就提交一次。

具体做法是一个小循环：

1. 确认工作区干净（git status 显示没有未提交的改动）；
2. 给智能体一个小任务；
3. 在浏览器里验证，看 /diff，确认没有越界；
4. 满意，就让它提交；不满意，git restore 或 /rewind 回到第 1 步；
5. 开始下一个任务。

这样，你的历史会变成一串可以任意回头的存档点。哪怕某次大胆的尝试彻底搞砸了，最坏的结果也只是回到上一个存档。这才是敢于放手让它做的底气。

还有两条小提醒：

• 提交只是在你自己的电脑上存档。把代码上传到 GitHub 之类的远程仓库（push）是另一件事，涉及别人能不能看到，这一步先别急，等你理解了再做；
• 开启一个新任务之前先提交或丢弃旧改动，别让不同任务的改动混在一起，否则 git diff 会变得很难读。

动手试一试

用你的番茄钟项目，完整走一遍存档与回滚：

到这里，「起步」路径就完成了：你已经选好了工具，装好了环境，做出了第一个项目，学会了和智能体沟通，并且有了随时能退回的底气。接下来，推荐进入Claude Code 精通路径，从它内部怎么工作开始，系统掌握记忆、权限、上下文等进阶功能。