版本控制与协作 / 系统课时
比较工作区与暂存区
比较工作区与暂存区
学习目标
完成本课后,你将能够:
- 使用 git diff 查看未暂存修改
- 读懂补丁中的上下文、删除和新增行
- 限制比较范围并发现意外变化
问题背景或应用场景
编辑文件后,状态只能说明“有修改”,不能说明修改内容是否正确。git diff 展示工作区相对暂存区的未暂存差异,是暂存前代码自检的第一道关口。
核心原理
默认 git diff 比较工作区和暂存区。补丁中的 - 行来自比较基准,+ 行来自当前工作区;它们不是简单的“删除和新增操作日志”,而是两个版本的行级对比。以 @@ 开头的块头表示差异所在行范围。
二进制文件通常无法显示文本补丁;换行符、编码或自动格式化可能让差异远大于实际语义变化。需要统计时使用 --stat,只看词级变化可尝试 --word-diff,但最终仍应结合语言格式和测试判断。
基础用法
在暂存前运行 git diff -- <path>。输出较大时先运行 git diff --stat 判断范围。确认差异正确后执行 git add;此时默认 diff 应为空,因为工作区已经与暂存区一致,但差异仍可通过 git diff --staged 查看。
完整可运行示例
以下命令使用 Bash 语法,并在独立测试目录中执行。示例会设置仓库级身份,不会修改正式项目;提交哈希、默认分支名和绝对路径等动态值以占位符表示,实际输出可能不同。
bash
rm -rf git-diff-worktree-demo
mkdir git-diff-worktree-demo
cd git-diff-worktree-demo
git init -q
git config user.name "Anystack Student"
git config user.email "student@example.com"
printf "timeout=10\nmode=dev\n" > app.conf
git add app.conf
git commit -q -m "chore: add config"
printf "timeout=20\nmode=dev\n" > app.conf
git diff -- app.conf预期输出
text
diff --git a/app.conf b/app.conf
--- a/app.conf
+++ b/app.conf
@@ -1,2 +1,2 @@
-timeout=10
+timeout=20
mode=devTips
- 暂存前逐文件检查 diff,避免把编辑器自动修改一起提交。
- 使用
--check检查尾随空格等空白问题。 - 大型差异先看
--stat,再按路径分段审查。
常见错误
1. 暂存后默认 diff 为空
- 错误表现:误以为修改丢失。
- 正确处理:默认 diff 不看暂存区,改用
git diff --staged。
2. 把加减号当成文件实际字符
- 错误表现:复制补丁时误把前缀写入文件。
- 正确处理:补丁前缀描述比较结果,不属于普通内容。
本课练习
1. 检查单行修改
- 任务目标:检查单行修改。
- 输入或初始条件:提交一个两行配置文件。
- 实现要求:修改一行并查看差异。
- 验收条件:补丁只显示目标行变化。
2. 发现空白问题
- 任务目标:发现空白问题。
- 输入或初始条件:在行尾加入空格。
- 实现要求:使用
git diff --check。 - 验收条件:命令指出空白错误位置。
3. 比较路径范围
- 任务目标:比较路径范围。
- 输入或初始条件:同时修改两个文件。
- 实现要求:分别限制路径查看。
- 验收条件:每次输出只包含指定文件。
按自己的节奏,确认真正理解。