【Git “diff“ 命令详解】

---

前言

Git 中的 diff 命令是一个非常强大且常用的工具，用于比较文件、分支、提交和工作区之间的差异。它可以帮助开发者快速识别哪些代码发生了变化，以及这些变化的具体内容。无论是查看尚未提交的更改，还是查看不同分支或提交之间的差异，git diff 都是一个不可或缺的工具。

本文将详细介绍 git diff 命令，包括其基本语法、常用选项、实际示例、进阶用法以及常见问题解答，帮助开发者高效地利用这一工具。

---

1. 命令简介

git diff 命令用于显示文件或提交之间的差异。它的输出显示了在文件内容上发生的变化，可以是新增的、删除的或修改的部分。通常用于：

• 查看工作区与暂存区的差异：查看当前修改但尚未添加到暂存区的内容。
• 查看暂存区与本地仓库的差异：查看已暂存的内容与最新提交之间的差异。
• 比较不同分支或提交之间的差异：检查不同分支、提交或文件的变化。

2. 命令的基本语法和用法

git diff 的基本语法如下：

git diff [选项] [<commit> <commit>]

• commit：指定要比较的提交。可以是分支、提交哈希或标签。
• 选项：用于定制差异输出的方式。

常见用法

查看工作区与暂存区的差异

git diff

此命令显示工作区（未暂存）与暂存区之间的差异。它帮助开发者查看尚未 git add 的修改内容。

查看暂存区与最新提交之间的差异

git diff --cached

此命令显示暂存区与最新提交之间的差异。它帮助开发者确认已经暂存的内容，与最新的提交相比，发生了哪些更改。

查看两个提交之间的差异

git diff commit1 commit2

这条命令将显示两个提交之间的差异，commit1 和 commit2 是两个有效的 Git 提交标识符（可以是提交哈希、分支名或标签名）。

3. 命令的常用选项及参数

git diff 提供了多个选项来帮助定制差异输出。以下是一些常用选项：

--cached 选项

• 显示暂存区与最后一次提交之间的差异，通常用于查看 git add 后的差异。

git diff --cached

--name-only 选项

• 仅显示更改的文件名，而不是详细的差异内容。

git diff --name-only

--stat 选项

• 显示更改文件的统计信息，如每个文件的新增行数和删除行数。

git diff --stat

--color 选项

• 启用彩色显示差异，增强可读性。

git diff --color

--word-diff 选项

• 以单词为单位而非行来显示差异，适合查看小的文本修改。

git diff --word-diff

-u 选项

• 以统一格式（unified diff format）显示差异，通常用于显示多行差异，适用于代码审查。

git diff -u

-w 选项

• 忽略空格的变化，只显示其他内容的差异。

git diff -w

-R 选项

• 反转差异的方向，显示与原来相反的修改。

git diff -R

4. 命令的执行示例

示例 1: 查看工作区与暂存区的差异

git diff

此命令会列出工作区与暂存区的所有差异。输出的内容会显示哪些文件被修改了，哪些行发生了变化。

输出：

diff --git a/file.txt b/file.txt
index 83db48f..3a4d8e1 100644
--- a/file.txt
+++ b/file.txt
@@ -1,4 +1,4 @@
 Hello, world!
-This is the first line.
+This is the second line.

示例 2: 查看暂存区与最新提交的差异

git diff --cached

这条命令显示暂存区的修改与最新提交之间的差异。如果已经执行了 git add，但尚未提交，这个命令会帮助你查看暂存的内容。

输出：

diff --git a/file.txt b/file.txt
index 83db48f..3a4d8e1 100644
--- a/file.txt
+++ b/file.txt
@@ -1,4 +1,4 @@
 Hello, world!
-This is the first line.
+This is the third line.

示例 3: 查看两个提交之间的差异

git diff abc123 def456

此命令显示 abc123 提交和 def456 提交之间的差异。

输出：

diff --git a/file.txt b/file.txt
index 83db48f..3a4d8e1 100644
--- a/file.txt
+++ b/file.txt
@@ -1,4 +1,4 @@
 Hello, world!
-This is the first line.
+This is the fourth line.

示例 4: 查看文件名的差异

git diff --name-only

此命令会列出所有已修改的文件名，而不显示详细的内容差异。

输出：

file.txt

示例 5: 显示更改的统计信息

git diff --stat

此命令显示更改文件的统计信息，包括每个文件的新增行数和删除行数。

输出：

 file.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

5. 命令的进阶用法

比较两个分支之间的差异

你可以使用 git diff 比较不同分支之间的差异，而不仅仅是提交。例如，比较 feature 分支和 main 分支的差异：

git diff main..feature

比较某个文件在两个提交之间的差异

git diff abc123 def456 -- file.txt

此命令显示 file.txt 在 abc123 提交和 def456 提交之间的差异。

使用 git difftool 查看差异

如果你更喜欢图形界面的工具来查看差异，可以使用 git difftool。这个命令可以调用外部差异工具（如 Meld、KDiff3 等）来查看差异。

git difftool

6. 命令的常见问题与解答

问题 1: 如何忽略空格的变化？

可以使用 -w 选项忽略空格变化，仅显示其他差异：

git diff -w

问题 2: 为什么 git diff 显示的差异很复杂？

Git 显示的差异通常遵循统一格式（unified diff format），如果你不熟悉这种格式，可能会觉得有些复杂。你可以通过使用不同的选项（如 --stat 或 --name-only）来简化输出。

问题 3: 如何查看某个文件在两个提交之间的差异？

可以使用如下命令查看指定文件的差异：

git diff commit1 commit2 -- path/to/file

7. 总结与建议

git diff 是 Git 中一个非常有用的工具，能够帮助开发者查看不同版本、分支或提交之间的差异。它能够在开发过程中帮助我们快速定位变更，进行代码审查和协作。

最佳实践建议：

• 定期查看差异：在提交之前，通过 git diff 查看代码差异，确保代码的正确性。
• 利用 --stat 查看统计信息：在代码审查时，使用 --stat 来快速了解每个文件的更改情况。
• 结合 git difftool 使用：对于复杂的差异，使用图形化工具 git difftool 可以使比较变得更加直观。

通过熟练掌握 git diff 命令，开发者能够