版本控制与协作 / 系统课时

比较两个提交版本

比较两个提交版本

学习目标

完成本课后,你将能够:

  • 比较任意两个提交的内容
  • 理解 A..B 在 diff 中的含义
  • 使用路径和状态统计定位版本变化

问题背景或应用场景

定位回归、整理发布说明或审查功能分支时,需要比较两个已提交版本,而不是只看当前工作区。Git 可以使用提交哈希、分支名、标签或相对引用选择任意快照,并计算它们之间的差异。

核心原理

git diff A B 比较 A 和 B 两个 tree 快照,输出把 A 变成 B 所需的差异。在 diff 语境中 A..B 通常等价于 A B;但在 git log A..B 中,两点语法表示可达提交集合,不应把不同命令的语义混为一谈。

三点比较 A...B 在 diff 中通常以两者合并基点为起点,与 B 比较,适合查看功能分支自分叉以来引入的变化。当前阶段先掌握明确的双提交比较,再在分支协作中使用三点语法。

基础用法

先用 git log --oneline 找到两个引用,再运行 git diff --name-status A B 查看路径范围,最后查看完整差异。只关注某文件时追加 -- path。可用 HEAD~1 表示当前提交的第一个父提交,适合比较最近一次变化。

完整可运行示例

以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。

bash
rm -rf git-compare-commits-demo
mkdir git-compare-commits-demo
cd git-compare-commits-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "version=1\n" > app.conf
git add app.conf
git commit -q -m "chore: add version one"
git tag v1
printf "version=2\nfeature=true\n" > app.conf
git add app.conf
git commit -q -m "feat: enable feature"
git tag v2
git diff --name-status v1 v2
git diff v1 v2 -- app.conf

预期输出

text
M	app.conf
diff --git a/app.conf b/app.conf
--- a/app.conf
+++ b/app.conf
@@ -1 +1,2 @@
-version=1
+version=2
+feature=true

Tips

  • 先看路径状态,再深入完整补丁。
  • 比较命令中的引用可混用标签、分支和哈希,但必须确认它们指向预期提交。
  • 记录发布差异时优先使用稳定标签而不是易移动的分支名。

常见错误

1. 颠倒比较方向

  • 错误表现:新增和删除方向与预期相反。
  • 正确处理:明确命令表达“从 A 变到 B”,必要时交换两个引用。

2. 混淆 log 与 diff 的两点语法

  • 错误表现:错误理解提交集合或快照差异。
  • 正确处理:根据具体命令解释语法,不套用同一结论。

本课练习

1. 比较相邻提交

  • 任务目标:比较相邻提交。
  • 输入或初始条件:创建两个版本。
  • 实现要求:使用 HEAD~1 HEAD 比较。
  • 验收条件:输出与第二次修改一致。

2. 比较标签

  • 任务目标:比较标签。
  • 输入或初始条件:为两个稳定版本创建标签。
  • 实现要求:输出路径状态和完整差异。
  • 验收条件:结果能说明版本变化。

3. 限制路径

  • 任务目标:限制路径。
  • 输入或初始条件:两个版本修改多个文件。
  • 实现要求:只比较指定目录。
  • 验收条件:输出不包含其他路径。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

比较两个提交版本

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通