看懂 git status / diff / staged

AI 改完代码后，不要马上提交。先看清楚它到底改了哪些文件。

最常用的是这三个命令：

git status --short
git diff
git diff --staged

一、看文件状态

git status --short

常见结果：

显示	含义
M docs/index.md	文件被修改
A docs/new/index.md	文件已新增并暂存
D old.md	文件被删除
?? notes.md	新文件，还没有被 Git 跟踪

看到 ?? 时要特别注意。新文件可能是你想提交的教程，也可能是临时文件、截图、密钥文件。

二、看还没暂存的改动

git diff

这个命令显示“已经被 Git 跟踪，但还没有 git add 的改动”。

它适合检查：

• AI 有没有删除原文
• 有没有改错页面
• 有没有把密钥写进文档
• 有没有改了无关文件

三、看已经暂存的改动

如果你执行过：

git add .

再执行：

git diff

可能看不到内容，因为改动已经进入暂存区。

这时要看：

git diff --staged

提交前建议一定跑一次。

四、新文件怎么看

git diff 默认不显示 ?? 新文件内容。你需要自己打开文件检查，或者先添加后再看 staged diff：

git add docs/new-page/index.md
git diff --staged

确认没问题后再提交。

如果发现加错了，可以取消暂存：

git restore --staged docs/new-page/index.md

五、提交前检查清单

提交前至少确认：

• 没有 API Key、Token、密码
• 没有 .env 这类本地配置文件
• 没有无关截图、压缩包、临时文件
• 删除的内容确实应该删除
• 新增页面已经加到导航或侧边栏
• 构建命令能通过

六、复制给 AI 的检查模板

请帮我检查当前 Git 改动。

要求：
1. 先运行 git status --short
2. 再查看 git diff
3. 如果有暂存内容，再查看 git diff --staged
4. 判断有没有 API Key、密码、无关文件或误删内容
5. 先总结风险，不要直接提交

小提示

看懂 diff 是使用 AI 编程最重要的基本功之一。你不需要一开始完全看懂每一行，但至少要知道它改了哪些文件、有没有删掉不该删的内容。