git diff 默认对比暂存区与工作区;若无输出,通常因文件已 git add 或为未跟踪/被忽略文件;验证需用 git diff 或 vscode 中“compare working tree with index”命令。

git diff 不加参数就是对比暂存区与工作区,这是它最核心、最默认的行为,不是“需要配置”或“要记命令别名”的事——它本来就是干这个的。
为什么 git diff 没输出,但文件明明改了
最常见原因是:你已经 git add 过该文件,此时暂存区和工作区内容一致,git diff 自然为空。
- 运行
git status看输出:如果文件出现在 “Changes to be committed” 下,说明它已在暂存区,git diff就不会显示它 - 新创建的未跟踪文件(untracked)也不会出现在
git diff输出里,哪怕你改了保存了——它连暂存区都没有,没法比 - 文件被
.gitignore忽略后,即使已跟踪,后续修改也可能不参与 diff(取决于 ignore 规则生效时机)
如何精准触发并验证“暂存区 vs 工作区”对比
不要依赖右键菜单或模糊点击,用明确命令确保对比对象无误:
- 终端中直接执行
git diff,它默认且唯一地比较工作区与暂存区 - VSCode 中按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入并执行Git: Compare Working Tree with Index—— 名称里的Working Tree就是工作区,Index就是暂存区 - 在 VSCode 的 Git 面板里,必须点 “STAGED CHANGES” 区域下的文件,才能看到左侧为暂存区、右侧为工作区的视图;点 “CHANGES” 下的文件,实际是反向逻辑(工作区 vs 暂存区的另一种呈现),且仅当文件已暂存才出现
对比时容易忽略的关键细节
diff 结果本身不带上下文标注,你需要自己判断“哪边是旧、哪边是新”:
- 在终端输出中:
git diff的->行表示“从暂存区删掉”,+>行表示“往工作区加上”——即左侧(减号)是暂存区快照,右侧(加号)是当前工作区内容 - 在 VSCode diff 视图中:左侧是暂存区(灰色背景块),右侧是工作区(白色块);点击行号旁的
>箭头,会把右侧改动复制到左侧,等效于对该行执行git add -p -
git diff -w可忽略空格变化,但要注意:某些格式化操作(如 Prettier 保存时自动缩进)会让 diff 失去意义——建议临时关掉editor.formatOnSave再比对
真正难的不是命令怎么写,而是每次运行前先问一句:我现在想确认的是“还没暂存的改动”,还是“已暂存但怕提交错的内容”?前者用 git diff,后者必须用 git diff --staged。混淆这两者,是绝大多数 diff 相关问题的根源。











