1. 简介
Git 是一个版本控制系统（VCS），具备追踪、合并和恢复变更的能力。它通过解决同一文件不同版本之间的冲突来实现这些功能。在实际使用中，空白字符（whitespace）的变更常常是导致冲突的根源之一，但有时候我们并不希望这些差异影响我们的判断。
在本教程中，我们将探讨在 Git 中如何忽略空白差异。主要内容包括：
- Git 如何处理换行符（line endings）
- 在
git diff、git rebase、git blame、git apply、git merge和git status等命令中如何控制空白差异 - 实际使用中的一些技巧和注意事项
本文中所有命令均在 Debian 12（Bookworm）上测试通过，使用 GNU Bash 5.2.15。除非另有说明，大部分内容适用于 POSIX 兼容环境。
2. 换行符与 Git
常见的行结束符（EOL）主要有以下几种：
<CR><LF>（即\r\n）——Windows 系统使用<CR>（即\r）——早期 macOS 使用<LF>（即\n）——Linux 和现代 macOS 使用
一些语言如 Python，使用 \n 表示换行，但在不同平台下会被自动替换为该平台的默认换行符。而 Perl 等语言则需要手动处理。
Git 本身可以识别这些换行符，并允许用户指定在提交和检出时是否进行转换：
checkout用 CRLF，commit用 LF（自动转换）checkout不变，commit用 LF（可能转换）checkout与commit都不变（不转换）
如果我们选择了最后一种方式（不处理换行），在查看 diff 或合并时仍可能遇到换行差异的问题。此时，我们可以选择忽略这些差异，以避免不必要的冲突或误判。
3. 使用 git diff 或 git rebase 时
git diff 是 Git 中最基础的比较命令之一，git rebase 也依赖其进行变更的比较。因此，掌握如何控制 diff 中的空白差异非常重要。
以下是一些常用选项：
3.1 忽略换行符差异
--ignore-cr-at-eol：忽略行尾的<CR>（适用于 Windows 与 Linux 混合开发）--ignore-space-at-eol：忽略行尾的所有空白（包括空格和<CR>）
✅ 示例：
$ git diff crlf lf
diff --git a/crlf b/lf
index af8c8f8..090219e 100644
--- a/crlf
+++ b/lf
@@ -1,3 +1,3 @@
-Line 1.
-Line 2.
+Line 1.
+Line 2.
$ git diff --ignore-cr-at-eol crlf lf
$
3.2 忽略空格差异
--ignore-space-change（或-b）：忽略行内空格变化，但保留空格是否存在--ignore-all-space（或-w）：完全忽略所有水平空格
✅ 示例：
$ git diff --ignore-space-change crlf lf
$
$ git diff --ignore-all-space crlf lf
$
⚠️ 注意：-w 不会忽略垂直空白（如空行），只忽略水平空白。
3.3 自定义忽略规则
--ignore-matching-lines=<REGEX>（或-I<REGEX>）：根据正则表达式忽略整行变更
⚠️ 注意：这个选项是按行忽略的，如果正则匹配整行，可能导致整行被忽略，甚至整个文件被跳过。
4. 使用 git blame 时
git blame 用于查看每一行的最后修改者和提交信息：
$ git blame file
c666beef (root 2024-01-10 10:00:01 -0600 1) repo
如果某次提交仅修改了空白，可以使用 -w 参数忽略这些变更：
✅ 示例：
$ git blame file
c666beef (user2 2024-01-10 10:00:01 -0600 1) repo
$ git blame -w file
^0667dea (user1 2024-01-10 10:01:00 -0600 1) repo
此时，user2 的提交仅涉及空白变更，-w 会忽略这些变更，显示 user1 为该行的最后实质修改者。
5. 使用 git apply 时
git apply 用于应用补丁（patch）。补丁中可能包含空白变更，我们可以通过 --whitespace=<ACTION> 控制处理方式：
nowarn：不提示警告warn（默认）：提示警告但应用补丁fix：提示警告、自动修复并应用error：提示警告、不应用补丁error-all：提示所有警告、不应用补丁
默认检查的空白问题包括：
- 行尾空格
- 仅含空白的行
- 缩进中空格后接 Tab
⚠️ 注意：这些行为受 core.whitespace 配置控制，可根据项目规范调整。
6. 使用 git merge 时
git merge 使用 diff 工具检测冲突。我们可以通过 -X 参数将 diff 的空白控制选项传递给 merge：
常用选项：
-Xignore-space-change-Xignore-all-space-Xignore-space-at-eol-Xignore-cr-at-eol
✅ 示例：
$ git merge -Xignore-cr-at-eol b1
这表示在合并分支 b1 时忽略换行符差异。
7. 使用 git status 与其它命令时
有些命令如 git status 并不支持直接忽略空白变更。但我们可以借助 shell 脚本实现过滤：
✅ 示例：
$ for modfile in $(git status | awk '$0 ~ /modified/ {print $2}'); do
if test -z "$(git diff --ignore-all-space $modfile)"; then
echo $modfile
fi
done
这段脚本会列出所有“仅空白变更”的文件，帮助我们快速识别哪些文件的修改不值得关注。
8. 总结
Git 提供了丰富的选项来控制空白字符的比较行为，适用于多种场景：
| 命令 | 支持选项 | 用途说明 |
|---|---|---|
git diff |
-w, -b, --ignore-cr-at-eol 等 |
控制 diff 显示空白的方式 |
git blame |
-w |
忽略空白变更，显示实质修改者 |
git apply |
--whitespace=... |
控制补丁应用时的空白处理 |
git merge |
-Xignore-... |
合并时忽略空白差异 |
git status |
无原生支持，需脚本处理 | 过滤仅空白变更的文件 |
合理使用这些功能，可以有效避免因空白字符引起的误判和冲突，提高协作效率。