如何用git diff比较两个分支的代码差异？

Question

如何使用 `git diff` 准确比较两个分支之间的代码差异？在实际开发中，常遇到执行 `git diff branch1 branch2` 时输出内容不完整或顺序混乱的问题，尤其是在存在大量文件变更或二进制文件的情况下。此外，当两个分支的提交历史差异较大时，如何确保只查看特定范围内的变更（如仅限某个目录或文件）？同时，`git diff` 默认是否包含未暂存的修改？如何排除无关文件（如日志或构建产物）对差异对比的干扰？掌握正确的参数组合（如 `--name-only`、`--stat`、`--no-color` 等）对于高效审查代码变更至关重要。

Answer 1

一、基础概念：理解 git diff 的核心作用与默认行为

git diff 是 Git 中用于比较文件差异的核心命令，广泛应用于代码审查、合并前预检和变更追踪等场景。其最基本的形式是：
git diff branch1 branch2，该命令会输出两个分支之间的所有差异内容。

但需注意的是：此命令默认不包含工作区中未暂存的修改。它仅比较两个分支的最后一次提交（即 HEAD 指针所指）之间的差异。如果当前工作目录有未添加到暂存区的更改，这些不会被纳入 git diff branch1 branch2 的结果中。

例如：

git diff main feature/login

这条命令将显示从 main 到 feature/login 所有被修改的行级差异。

二、常见问题剖析：为何输出不完整或顺序混乱？

• 大量文件变更导致终端输出受限：当差异涉及数百个文件时，终端可能因缓冲区限制而截断输出，造成“不完整”假象。
• 二进制文件干扰可视化：图片、编译产物等二进制文件无法以文本形式展示差异，Git 默认会跳过它们或提示“Binary files differ”，影响整体可读性。
• 文件变更顺序非字母序或路径序：Git 内部按对象存储顺序输出差异，可能导致目录结构混乱，不利于人工阅读。

此外，在高度分叉的分支历史中，直接比较两个远亲分支可能会引入大量无关变更，掩盖真正关注的逻辑改动。

三、精准控制范围：限定目录与文件的差异查看策略

为避免信息过载，可通过路径参数限制比较范围：

git diff branch1 branch2 -- src/components/
git diff branch1 branch2 -- app.js

上述命令分别只显示指定目录或文件的变更。这在大型项目重构或模块迁移时尤为有效。

参数	用途说明	适用场景
--name-only	仅列出变更文件名	快速扫描哪些文件被修改
--stat	统计每个文件增删行数	评估变更规模
--no-color	禁用颜色输出	日志记录或脚本处理
-b 或 --ignore-space-change	忽略空白变化	排除格式化干扰
--binary	显示二进制差异编码	调试打包工具输出
--minimal	力求最小化差异块	提升 diff 可读性

四、高级技巧：结合过滤机制排除无关文件干扰

构建产物（如 dist/、node_modules/）、日志文件（*.log）常污染 diff 输出。可通过以下方式排除：

git diff branch1 branch2 -- . ':!logs/' ':!*.tmp'

使用负向 glob 模式 ':!pattern' 忽略特定路径。也可借助 .gitattributes 文件标记某些路径为“diff=none”：

*.png diff=none
*.log -diff

这样 Git 将自动忽略这些类型的差异。

五、流程优化：构建高效代码审查的标准化 diff 流程

graph TD A[确定比较基准分支] --> B(检查本地是否同步最新提交) B --> C{是否需排除特定文件?} C -->|是| D[添加 :!path/to/exclude] C -->|否| E[继续] E --> F[选择输出格式: --stat / --name-only] F --> G[执行 git diff branch1..branch2] G --> H[重定向至文件或分页器]

建议搭配 | less 或 > diff.patch 进行后续分析：

git diff main feature/auth -- src/api/ --stat | less

六、实战案例：跨长期分支的安全差异分析

面对提交历史差异较大的分支（如主干与遗留特性分支），推荐使用三点差异法（three-dot diff）明确“对方新增”的变更：

git diff main...feature/payment

这等价于：git diff $(git merge-base main feature/payment) feature/payment，仅显示从共同祖先到目标分支的独特变更，避免双向噪音。

反之，两点差异（two-dot）main..feature 显示两者之间所有差异，适合临近合并前的最终核对。