Git中忽略文件机制的.gitignore与.git/info/exclude两种方式详解

好的，我们来详细解析 Git 中两种用于忽略文件的机制：.gitignore 和 .git/info/exclude。

这两种机制的核心目的相同：告诉 Git 哪些文件或目录不应该被跟踪（track）和管理。但它们的作用范围、共享方式和优先级有所不同。

1. `.gitignore` 文件

这是最常用、最广为人知的忽略机制。

作用与特点

项目级配置：通常放置在 Git 仓库的根目录下，也可以存在于子目录中。它会影响整个仓库（以及克隆此仓库的所有人）。
共享性：由于它通常作为项目的一部分被提交到版本库中（git add .gitignore），因此它的规则会对所有协作者生效。这意味着团队可以就哪些文件需要被忽略达成共识（例如，忽略编译生成的二进制文件、日志文件、IDE配置文件等）。
模式匹配：支持标准的通配符模式匹配。

语法规则

# 开头的行是注释。
空行会被忽略。
* 匹配任意数量的字符（不包括路径分隔符 /）。
? 匹配单个字符。
** 匹配任意层级的目录（例如 a/**/z 可以匹配 a/z, a/b/z, a/b/c/z）。
/ 在模式开头表示相对于 .gitignore 文件所在目录的路径。例如 /TODO 只忽略根目录下的 TODO 文件，而不忽略 src/TODO。
/ 在模式结尾表示这是一个目录。例如 build/ 会忽略所有名为 build 的目录及其内容。
! 表示取反（例外规则）。例如，要忽略所有 .log 文件，但不忽略 important.log，可以这样写： *.log !important.log 注意：如果父目录被忽略，则无法对目录内的文件使用 ! 取消忽略。

常见用法示例

一个典型的项目根目录下的 .gitignore 文件可能长这样：

# 忽略 IDE 配置文件
.vscode/
.idea/
*.swp
*~

# 忽略操作系统生成的文件
.DS_Store
Thumbs.db

# 忽略编译输出和依赖目录
/bin/
/build/
/node_modules/
/target/

# 忽略日志文件和运行时文件
*.log
*.tmp
*.pid

# 忽略环境变量文件（通常包含敏感信息）
.env
.env.local

工作流程

在项目根目录创建 .gitignore 文件。
按照上述语法添加忽略规则。
将 .gitignore 文件本身添加到 Git：git add .gitignore
提交更改：git commit -m "Add project .gitignore"

此后，任何克隆此仓库的人都会自动继承这些忽略规则。

2. `.git/info/exclude` 文件

这个文件是 Git 的另一种忽略机制，但知名度较低。

作用与特点

本地级配置：它是一个位于 Git 仓库内部的文件（路径为 .git/info/exclude），不会被 Git 跟踪，也不会被提交到版本库。
私有性：它的规则仅对本地仓库生效，不会影响其他协作者。这意味着你可以在这里放置一些个人化的、不适合分享的忽略规则。
优先级：它的优先级高于 .gitignore。如果一个文件同时被两者匹配，.git/info/exclude 的规则会胜出（即该文件会被忽略）。

语法规则

其语法与 .gitignore 完全相同。

常见用法示例

假设你的项目有一个 .gitignore 文件，其中忽略了所有 .txt 文件：

*.txt

但你在本地有一个非常重要的 notes.txt 文件，你希望 Git 忽略除了它之外的所有 .txt 文件。你有两个选择：

修改 .gitignore（不推荐，因为这会改变团队共享的规则）： *.txt !notes.txt
在 .git/info/exclude 中添加一条例外规则（推荐，因为这是你个人的需求）： # 我的个人笔记，不想被提交，但也不想从项目的 .gitignore 中移除 *.txt 规则 !notes.txt 等等，这里有个陷阱！如果父目录模式已经匹配并忽略了该文件，直接 ! 可能无法生效。更常见的用法是忽略那些你个人产生但永远不想纳入版本控制的文件。

更合理的例子：

忽略个人调试文件：你的编辑器可能会生成一个与你个人账号相关的临时文件，比如 debug_[你的用户名].log。这个文件对其他人无意义，不应加入项目的 .gitignore。 # 在 .git/info/exclude 中添加 debug_john_doe.log
忽略本地特有的大型测试数据集：你的机器上有一个很大的本地测试数据目录，克隆仓库的其他人可能没有或不需此数据。 # 在 .git/info/exclude 中添加 /local_test_data/
覆盖共享的 .gitignore：如果团队的 .gitignore 忽略了一个你本地需要修改的配置文件（如 config.yml），你可以将其加入 .git/info/exclude 来强制 Git 停止忽略它（但通常更好的做法是将该文件加入 .gitignore 的例外，或者使用 git add -f 强制添加）。不过，直接使用 ! 在 .git/info/exclude 中通常是无效的，因为上层模式已经匹配。这种情况下，正确的做法是不要在共享的 .gitignore 中忽略这个文件，或者将其从共享规则中移除。

简单来说，.git/info/exclude 的最佳实践是：用于忽略那些纯粹是你本地环境产生的、与项目无关、且不适合放入项目级 .gitignore 的文件。

编辑方式

由于该文件不在工作区，你需要直接导航到仓库的 .git/info/ 目录下编辑 exclude 文件，或者使用命令行：

# 使用 echo 追加规则（Linux/macOS/Git Bash）
echo "debug_john_doe.log" >> .git/info/exclude

# 使用 echo 追加规则（Windows Command Prompt）
echo debug_john_doe.log >> .git/info/exclude

# 使用记事本等编辑器打开
notepad .git/info/exclude  # Windows
open -a TextEdit .git/info/exclude # macOS

总结与对比

特性	`.gitignore`	`.git/info/exclude`
作用范围	整个仓库（项目级）	本地仓库（个人级）
是否受 Git 跟踪	是（通常应提交到版本库）	否（永远不会被提交）
共享性	对所有协作者可见并生效	仅对本地仓库生效，不影响他人
优先级	较低	较高（可覆盖 `.gitignore` 的规则）
适用场景	定义项目通用的忽略规则（如构建产物、依赖、IDE配置）	定义个人本地的特殊忽略规则（如个人调试文件、本地特有数据）

补充：全局忽略 (`core.excludesFile`)

除了以上两种，Git 还有一个全局忽略机制。它作用于你系统上的所有 Git 仓库。

配置方法：通过 git config --global core.excludesFile ~/.gitignore_global 设置一个全局的忽略文件路径。
作用：用来忽略所有项目都会产生的、与个人环境相关的文件。例如，在所有项目中都忽略 .DS_Store (macOS)、Thumbs.db (Windows) 或你自己偏好的编辑器配置。
优先级：全局忽略文件的优先级低于项目级的 .gitignore 和 .git/info/exclude。