Git忽略文件不止.gitignore一种方式

背景

在 Git 的日常使用中，.gitignore 文件几乎是所有开发者的标配。我们习惯将不需要版本控制的文件（如编译产物、IDE 配置、系统临时文件等）添加到这个文件中，以确保它们不会被意外提交。然而，许多资深开发者可能并未意识到，.gitignore 仅仅是 Git 忽略文件机制的一部分。

实际上，Git 提供了三个不同层级的文件来管理忽略规则。理解这三者的区别和适用场景，能够帮助开发者更精细地控制版本控制行为，特别是在处理个人工作流偏好、团队协作规范以及全局系统文件时。

核心内容

Git 允许用户在三个不同的层级定义忽略规则，分别是：

1. .gitignore：仓库级别的忽略文件。
2. .git/info/exclude：仓库级别的本地排除文件。
3. ~/.config/git/ignore：用户级别的全局忽略文件。

1. .gitignore：标准的仓库忽略文件

这是最常见的使用方式。.gitignore 文件通常位于项目的根目录下，并且会随代码一起被提交到 Git 仓库中。

• 作用范围：针对特定仓库。
• 共享性：所有克隆该仓库的开发者都会继承这些忽略规则。
• 适用场景：用于忽略那些对项目所有参与者都通用的文件，例如构建输出目录、依赖包文件夹（如 node_modules）、日志文件等。

2. .git/info/exclude：仓库级别的本地排除

这个文件位于每个 Git 仓库的 .git 目录内部（即 .git/info/exclude）。与 .gitignore 不同，对该文件的修改不会被提交到 Git 仓库中。

• 作用范围：仅对当前仓库的本地用户生效。
• 共享性：不共享，其他协作者看不到这里的规则。
• 适用场景：当你有一些个人特有的文件需要忽略，但不希望将其添加到 .gitignore 中以免污染团队共享配置时，可以使用此文件。例如，你有一个个人笔记文件 notes.txt，只在你的工作流中使用，不想提交也不想让队友看到，就可以将其添加到 .git/info/exclude 中。

3. ~/.config/git/ignore：用户级别的全局忽略

这个文件位于用户的主目录中（路径为 ~/.config/git/ignore）。在此文件中添加的文件名将在计算机上的所有 Git 仓库中被忽略。

• 作用范围：全局，适用于当前用户的所有 Git 仓库。
• 共享性：不共享，仅对当前用户机器生效。
• 适用场景：用于忽略那些在每台开发机器上都存在、且不希望在任何仓库中出现的系统文件或编辑器备份文件。例如，在 macOS 上，将 .DS_Store 添加到此文件中，可以确保该文件在所有仓库中都被自动忽略，而无需在每个项目中单独配置。

自定义全局忽略文件

Git 允许用户自定义全局忽略文件的路径。默认情况下，Git 使用 ~/.config/git/ignore，但你可以通过配置将其指向其他文件。

例如，如果你想使用 ~/.gitignore_global 作为全局忽略文件，可以运行以下命令：

git config --global core.excludesFile ~/.gitignore_global

若要恢复默认设置，可以运行：

git config --global --unset core.excludesFile

如何检查文件被哪个规则忽略？

当你在多个层级添加了忽略规则时，可能会疑惑某个具体文件是被哪条规则忽略的。Git 提供了 git check-ignore -v 命令来诊断这一问题。

以检查 .DS_Store 为例，在不同配置下的输出结果如下：

场景 A：被仓库的 .gitignore 忽略

$ git check-ignore -v .DS_Store
.gitignore:1:.DS_Store .DS_Store

输出显示规则来自 .gitignore 文件的第 1 行。

场景 B：被仓库的 .git/info/exclude 忽略

$ git check-ignore -v .DS_Store
.git/info/exclude:7:.DS_Store .DS_Store

输出显示规则来自 .git/info/exclude 文件的第 7 行。

场景 C：被全局 ~/.config/git/ignore 忽略

$ git check-ignore -v .DS_Store
/Users/nelson/.config/git/ignore:2:.DS_Store .DS_Store

输出显示规则来自用户主目录下的全局忽略文件。

场景 D：被自定义全局忽略文件忽略

$ git check-ignore -v .DS_Store
/Users/nelson/.gitignore_global:1:.DS_Store .DS_Store

输出显示规则来自自定义的全局文件。

注意：如果没有任何规则忽略该文件，git check-ignore -v 命令将不会产生任何输出。

关键要点

• 层级分明：Git 的忽略机制分为三个层级：仓库共享（.gitignore）、仓库本地私有（.git/info/exclude）和用户全局（~/.config/git/ignore）。
• .gitignore 是共享的：它随代码提交，适用于团队通用的忽略规则。
• .git/info/exclude 是私有的：它位于 .git 目录内，不随代码提交，适用于个人特有的、不想污染团队配置的忽略规则。
• 全局忽略适用于系统文件：~/.config/git/ignore 适用于忽略操作系统或编辑器产生的、在所有项目中都应忽略的文件（如 macOS 的 .DS_Store）。
• 全局配置可自定义：可以通过 git config --global core.excludesFile 修改全局忽略文件的路径。
• 诊断工具：使用 git check-ignore -v <filename> 可以准确查看某个文件是被哪个层级的哪个规则忽略的，便于排查问题。

意义与影响

理解 Git 的三级忽略机制对于提升开发效率和规范版本控制具有重要意义：

1. 保持仓库整洁：通过将个人特有的忽略规则（如本地测试数据、个人笔记）放入 .git/info/exclude，可以避免向 .gitignore 中添加大量与团队协作无关的条目，使共享的忽略文件更加简洁、通用。
2. 减少重复配置：利用全局忽略文件，开发者无需在每个新项目中重复添加相同的系统级忽略规则（如 IDE 配置文件、操作系统元数据文件），实现了“一次配置，处处生效”。
3. 增强可维护性：明确区分共享规则和本地规则，有助于新加入的团队成员快速理解项目的版本控制策略，减少因个人配置差异导致的混淆。
4. 问题排查更高效：掌握 git check-ignore -v 命令，使得在遇到意外忽略或未被忽略的文件时，能够快速定位问题根源，节省调试时间。

总之，善用这三层忽略机制，可以让 Git 的使用更加灵活、高效，同时保持项目配置的清晰和整洁。