Beyond The Memory

Git功能分支代码差异比较完全指南

核心命令速查

1. 直接比较两个分支

# 比较两个分支的所有差异
git diff feature-branch-a feature-branch-b

# 比较特定文件在两个分支中的差异
git diff feature-branch-a feature-branch-b -- path/to/file.js

2. 比较分支与共同祖先

# 查看feature-branch相对于master的变化（三点语法）
git diff master...feature-branch

# 等价于下面的命令组合
git diff $(git merge-base master feature-branch) feature-branch

3. 查看提交历史差异

# 查看在feature-branch中但不在master中的提交
git log master..feature-branch --oneline

# 查看两个分支的图形化提交历史
git log --oneline --graph --decorate master feature-branch

# 查看分支分歧点
git merge-base master feature-branch

4. 详细差异分析

# 显示文件统计信息
git diff --stat master feature-branch

# 显示每个文件的修改行数
git diff --numstat master feature-branch

# 只显示文件名列表
git diff --name-only master feature-branch

# 显示新增、删除、修改的文件分类
git diff --name-status master feature-branch

5. 使用Commit ID进行比较

# 比较两个特定的提交
git diff abc1234 def5678

# 比较一个提交与当前状态
git diff abc1234 HEAD

# 比较一个提交与工作目录（未提交的修改）
git diff abc1234

# 查看某个提交的详细信息
git show abc1234

# 查看某个提交引入的变化
git show abc1234 --stat

# 比较某个提交与其父提交
git diff abc1234^ abc1234
# 或者使用
git show abc1234

# 比较某个提交与它的前N个提交
git diff abc1234~3 abc1234

6. Commit ID相关的实用技巧

# 查找包含特定内容的提交
git log -S "function_name" --oneline

# 通过提交信息搜索
git log --grep="bug fix" --oneline

# 获取简短的commit hash
git rev-parse --short abc1234

# 获取完整的commit hash
git rev-parse abc1234

# 查看两个提交之间的所有提交
git log abc1234..def5678 --oneline

# 查看某个文件在特定提交中的内容
git show abc1234:path/to/file.js

实际使用场景

场景1：Code Review前的自检

# 检查当前功能分支相对于主分支的所有变化
git diff master...HEAD

# 查看即将合并的提交列表
git log master..HEAD --oneline

场景2：比较不同功能分支的实现方案

# 比较两个功能分支的实现差异
git diff feature/user-auth feature/oauth-integration

# 只查看特定目录的差异
git diff feature/user-auth feature/oauth-integration -- src/auth/

场景3：合并冲突预检查

# 查看两个分支的差异文件
git diff --name-only feature-a feature-b

# 模拟合并查看潜在冲突
git merge-tree $(git merge-base feature-a feature-b) feature-a feature-b

场景4：版本回滚和历史分析

# 比较当前版本与上个发布版本
git diff v1.2.0 HEAD

# 查看特定版本引入的Bug
git diff abc1234^ abc1234

# 分析某个提交到现在的所有变化
git diff abc1234 HEAD --stat

# 查看两个版本标签之间的差异
git diff v1.1.0 v1.2.0 --name-status

场景5：Cherry-pick前的预览

# 预览要cherry-pick的提交会带来什么变化
git show abc1234

# 比较cherry-pick目标提交与当前分支
git diff HEAD abc1234

# 查看提交在原分支上下文中的位置
git log --oneline --graph abc1234~3..abc1234^

语法解释

两点 vs 三点语法

git diff A..B 等价于 git diff A B - 比较两个分支的当前状态
git diff A...B - 比较A和B的共同祖先与B的差异

提交范围语法

master..feature - 在feature中但不在master中的提交
feature..master - 在master中但不在feature中的提交
master...feature - 两个分支的对称差异（mutual exclusive commits）

高级技巧

1. 创建差异补丁

# 生成补丁文件
git diff master feature-branch > feature.patch

# 应用补丁
git apply feature.patch

2. 可视化工具

# 使用配置的diff工具
git difftool master feature-branch

# 使用特定的可视化工具
git difftool --tool=vimdiff master feature-branch

3. 忽略特定类型的差异

# 忽略空白字符差异
git diff -w master feature-branch

# 忽略行尾差异
git diff --ignore-cr-at-eol master feature-branch

常见陷阱与注意事项

⚠️ 常见错误

混淆两点和三点语法
- 使用错误的语法可能看到不相关的差异
- 记住：三点语法用于查看分支特有的变化
忘记指定基准分支
- git diff feature 比较的是工作区与feature分支
- 应该使用 git diff master feature
大文件差异性能问题
- 使用 --stat 先查看概览
- 对于大型二进制文件，考虑使用 --name-only

🔧 最佳实践

在合并前总是检查 git diff master...feature-branch
使用 --stat 快速了解变化规模
结合 git log 理解变化的上下文
对于复杂差异，使用可视化工具

📝 别名推荐

# 在 ~/.gitconfig 中添加
[alias]
    df = diff
    dfs = diff --stat
    dfn = diff --name-only
    branch-diff = "!f() { git diff $1...$2; }; f"
    feature-diff = diff master...HEAD

    # Commit ID 相关别名
    commit-diff = "!f() { git diff $1 $2; }; f"
    show-stat = show --stat
    last = log -1 HEAD --stat
    find-commit = "!f() { git log -S $1 --oneline; }; f"
    search-commit = "!f() { git log --grep=$1 --oneline; }; f"

总结

Git提供了灵活的分支和提交比较功能，关键是理解不同语法的含义：

分支比较

直接比较：git diff branchA branchB
基于共同祖先：git diff branchA...branchB
提交范围：git log branchA..branchB

Commit ID比较

两个提交：git diff commit1 commit2
提交与当前：git diff commit HEAD
单个提交变化：git show commit
提交与父提交：git diff commit^ commit

快速查找Commit ID

# 查看最近的提交
git log --oneline -10

# 通过内容查找
git log -S "关键字" --oneline

# 通过提交信息查找
git log --grep="提交信息" --oneline

选择合适的命令和参数，可以精确了解不同功能分支或特定提交之间的代码差异，无论是用于代码审查、版本回滚还是历史分析。