版本控制与协作 / 系统课时
比较两个提交版本
比较两个提交版本
学习目标
完成本课后,你将能够:
- 比较任意两个提交的内容
- 理解 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=trueTips
- 先看路径状态,再深入完整补丁。
- 比较命令中的引用可混用标签、分支和哈希,但必须确认它们指向预期提交。
- 记录发布差异时优先使用稳定标签而不是易移动的分支名。
常见错误
1. 颠倒比较方向
- 错误表现:新增和删除方向与预期相反。
- 正确处理:明确命令表达“从 A 变到 B”,必要时交换两个引用。
2. 混淆 log 与 diff 的两点语法
- 错误表现:错误理解提交集合或快照差异。
- 正确处理:根据具体命令解释语法,不套用同一结论。
本课练习
1. 比较相邻提交
- 任务目标:比较相邻提交。
- 输入或初始条件:创建两个版本。
- 实现要求:使用
HEAD~1 HEAD比较。 - 验收条件:输出与第二次修改一致。
2. 比较标签
- 任务目标:比较标签。
- 输入或初始条件:为两个稳定版本创建标签。
- 实现要求:输出路径状态和完整差异。
- 验收条件:结果能说明版本变化。
3. 限制路径
- 任务目标:限制路径。
- 输入或初始条件:两个版本修改多个文件。
- 实现要求:只比较指定目录。
- 验收条件:输出不包含其他路径。
按自己的节奏,确认真正理解。