git diff 是 Git 版本控制系统中一个非常强大的命令，它用于显示工作目录（working directory）中的文件与暂存区（staging area）或某个特定提交（commit）之间的差异。这个命令对于代码审查、理解变更以及准备提交非常有帮助。下面将详细介绍 git diff 的用法与注意事项。

基本用法

比较工作目录与暂存区

git diff

这是 git diff 最常见的用法，它会显示自上次提交以来在工作目录中修改但尚未暂存（git add）的所有文件的差异。

比较暂存区与最近一次提交

git diff --cached
或者
git diff --staged

这两个选项是等价的，用于显示已暂存（git add）但尚未提交的更改。

比较工作目录与特定提交

git diff <commit-hash>

这个命令会显示工作目录与指定提交之间的差异。<commit-hash> 是你想要比较的提交的哈希值的前几位。

比较两个特定提交

git diff <commit-hash1> <commit-hash2>

这允许你比较两个不同提交之间的差异。默认情况下，比较的是这两个提交之间差异的部分，即 <commit-hash2> 相对于 <commit-hash1> 的变化。

比较两个文件

git diff <file1> <file2>

如果你想要比较工作目录中两个特定文件的差异，而不是基于 Git 版本控制的更改，可以直接使用文件名。但请注意，这不是 Git 特有的比较，更像是使用 diff 命令。

注意事项

理解工作目录、暂存区和提交

在使用 git diff 之前，务必理解 Git 的三个主要工作区域：工作目录、暂存区和仓库（包含提交历史）。这有助于你准确使用 git diff 及其选项。

使用 --color 选项

默认情况下，git diff 会以颜色编码输出差异，这有助于区分新增、删除和修改的行。如果你遇到没有颜色输出的情况，可以尝试使用 --color 选项强制开启颜色显示。

使用 --stat 选项获取概览

如果你只是想快速了解哪些文件被修改了，而不是查看具体的差异，可以使用 --stat 选项。这会提供一个文件列表和每个文件修改行数的统计。

忽略空格差异

有时，差异可能仅仅是由于空格或换行符的不同造成的。为了忽略这些差异，可以使用 --ignore-space-change、--ignore-all-space 或 --ignore-blank-lines 等选项。

比较不同分支或标签

虽然 git diff 主要用于比较工作目录、暂存区与提交之间的差异，但你也可以用它来比较两个不同分支或标签之间的差异，只需将 <commit-hash> 替换为分支名或标签名即可。

利用图形界面工具

虽然 git diff 在命令行中非常强大，但一些图形界面的 Git 客户端（如 SourceTree、GitKraken）也提供了直观的可视化差异比较工具，可能更适合某些场景。