最直接写法是 git diff branch1 branch2 -- path/to/file.js,它精确比对指定文件在两分支中的差异,输出带 +/- 的逐行变化;注意 -- 不可省略、路径须为仓库根目录相对路径、顺序决定基准分支。

git diff branch1 branch2 -- path/to/file.js 是最直接写法
别绕路,想看某个文件在两个分支里到底改了啥,就用这个命令。Git 会把 branch1 和 branch2 对应的该文件快照拉出来逐行比对,输出带 +/- 的差异块。
注意三点:
-
--符号不能省——它告诉 Git 后面是路径,不是分支名;漏掉可能报错或误读参数 - 路径必须相对于仓库根目录写,比如
src/api/client.ts,不能只写client.ts(哪怕你在src/api/目录下执行) - 如果文件在其中一个分支里已被删除,
git diff仍会显示“该文件被删”,但不会提示另一分支里新增了同名文件——那是git log的事
方向反了结果就完全不对
git diff feature login main -- package.json 表示「main 相比 feature login 新增/修改了什么」,即以 feature login 为基准,列出 main 里独有的改动。
常见错误是把顺序写反,比如本想看新功能分支改了啥,却写了 git diff main feature/login -- ...,结果看到的是主干里有、功能分支里没有的内容,容易误判。
实操建议:
- 心里默念“从左到右:A → B 的变更”,B 是你要审查的那个分支
- 不确定时先用
--name-only快速确认文件是否真有差异:git diff feature/login main --name-only -- package.json - 若输出为空,说明该文件在两分支中内容一致(或 Git 认为无文本差异)
过滤格式噪音,聚焦逻辑变动
JS/TS 项目常因 Prettier 自动格式化导致 diff 充满空格、换行、引号变化,掩盖真实逻辑改动。
加参数跳过这些干扰:
-
-w:忽略所有空白符变化(空格、制表符、换行) -
--ignore-space-change:更宽松,容忍缩进数量变化(如 2 空格 vs 4 空格) -
--word-diff=plain:按单词标差异,对 JSON 字段名、字符串值、注释等更友好
例如:git diff -w feature/login main --word-diff=plain -- src/utils/validation.js
VS Code 里点两下就能比,但得防工作区污染
在 VS Code 源代码管理视图中,右键分支名 → “Compare with Branch”,选目标分支,再点开具体文件,和命令行效果一致,还支持点击跳转、折叠、内联注释。
但有个隐藏坑:
- 如果当前工作目录有未提交修改(哪怕只是改了一行注释),GitLens 或内置比较会把它们一起混进去,变成“分支差异 + 本地脏数据”
- 解决方法:执行前先
git status确认干净;或者用git stash临时保存再比 - 图形界面不显示
-w这类参数效果,想忽略空白就得回到终端跑一次
真正难的不是命令怎么敲,而是判断“这个差异是不是我预期的逻辑改动”。有时候 git diff 显示大段重写,结果发现只是 linter 自动修复;有时候一行没变,但函数签名变了,git diff 却看不出调用链影响——这时候得结合 git log --oneline --graph 看上下文。











