阅读Git diff：区分实际修改行与上下文

Git diff显示两状态差异，而非重新显示修改文件全部。只跟红绿行，可能看见意图却漏比较对象或周边关系。先定比较什么，再按文件、块、代码行为顺序读更易理解。

命令输出为说明例，未实际在读者仓库执行或改文件。以官方一般补丁格式说明，工具、设置、合并可改变外观。不因行少就判影响小或已验证。

1. 先选择比较对象

默认git diff比较工作目录与暂存区，git diff --staged比较暂存区与最后提交。正如官方Git书，默认空不表示最后提交后无全部变更。

问题	命令示例	读取范围
尚未暂存修改？	git diff	暂存区与工作目录
已暂存修改？	git diff --staged	最后提交与暂存区
当前文件与HEAD差？	git diff HEAD	HEAD与当前工作内容
聚焦特定文件？	git diff -- src/label.py	该路径默认比较

例如修改、暂存再修改，同文件变化可分两范围。审查将提交内容读暂存，查未反映编辑读默认。问题对象不同，正确输出也可能误解。

执行前确认仓库目录与路径。示例文件不存在，无须创建同名新文件。改自身路径并读取比较。其他仓库例结果不作当前状态证据。

2. 文件头与修改行分读

补丁有路径与前后文件头。一般---、+++是文件信息，三字符加减别混代码标记。a、b前缀通常区分两边，路径迁移或设置可改变外观。

重命名、新文件、删除不同于内容修改。先读头确认哪个文件哪边。同函数多文件需注意路径，只复制行说明易漏。

备注命令、对象、路径。“当前目录label.py与HEAD差异”比只说改return明确。任意加不存在提交标识，可被读成其他状态修改。

3. 解释块起始行与行数

下面是处理名称前后空格的虚构补丁。@@ -5,3 +5,4 @@表示旧侧第5行起3行、新侧第5行起4行。假设函数前四行省略。

--- a/src/label.py
+++ b/src/label.py
@@ -5,3 +5,4 @@
 def label(name):
-    return name
+    cleaned = name.strip()
+    return cleaned
 # formatting helper

实际删return name一行，增两行。定义与末注释是上下文，并非全部块行都改。前后计数也含各侧上下文。

起始行变化也需理解。前修改移动后代码，同逻辑位置可不同编号。不将编号差直接当其他功能变化，结合函数条件。空行也可能上下文。

4. 将增删上下文关联实际行为

补丁从原字符串直接返回，改为整理前后空格后返回。问哪个输入结果变，可具体审查。无空格可能同结果，两端空格会改变。

修改不总好。需保留空格的领域可能违约，也需查非字符串输入。diff显示意图，不是决定实际要求的文档。

说明输入条件	审查问题	必要依据
无前后空格	原结果是否保持？	正常输入比较
有前后空格	移除是否要求？	输入规则与预期
空字符串	空值行为是否保持？	边界输入检查
非字符串值	允许还是拒绝？	调用条件与输入契约

表答案应由实际项目填。眼读一行与运行确认不同。分记代码预期影响与实检影响，便于理解证据范围。

5. 先列表后读重要文件

修改多可git diff --stat看概览，或--name-only看名称。输出帮助选择，不替代说明行为的全补丁。概要遗漏细节用文件diff查。

虚构组有输入、测试、文档。先读行为输入文件，对照测试，再查文档同规则。仅改名与改执行路径，不计相同影响。

审暂存，列表也应同条件。混默认列表与暂存补丁可能关联不同变化。维持比较标准比减少文件数重要。

6. 寻找空或过大输出原因

无输出先查对象，只剩暂存默认可能空。新未跟踪也不因只看默认就称全部确认。结合状态路径查包含什么。

全文件似改，查逻辑还是格式换行。因难看而全忽略，会漏有意义空格。区分显示与功能差，最终留必要原变化。

二进制或合并复合diff不能全按单边加减理解。不熟悉格式查官方。不把图片内容作文本补丁，或多父变更当单比较。

7. 将审查转为修改请求

提供文件、块、输入与预期。“需保留空格输入也strip，应区分条件”比此处奇怪具体。也明确代码候选或实际失败。

测试也改，查只是改预期通过，还是反映需求。删失败测试需查条件不再需要理由。新增测试行不保证正确。

结束记录对象、文件、行为、实际验证与问题，目标让再读者知需查什么。回退或提交前，也对照是否含用户其他编辑。

8. 可直接使用的阅读顺序

先记两状态看列表，头查对象类型，读块范围。从增删思考输入输出副作用，上下文查调用，最后对照验证。

顺序是理解补丁，并非运行成功或部署批准。一行可影响多调用，大格式可不改行为。按需求实际结果联系审查，比数文件行更有用。

官方来源与撰写标准

• Git：git-diff文档
• Pro Git：记录仓库变更

资料确认日期：2026-10-06。这是AI依据实际打开的官方资料撰写的说明。单独标注的计算、代码与检查案例用于说明，并非直接测试用户环境或实测结果。发布准备阶段已重新确认功能与官方资料是否改变。