Git忽略文件机制：.gitignore与.git/info/exclude详解

前言

在日常使用 Git 进行版本控制时，总有一些文件是我们不希望被纳入版本管理的——编译产物、日志文件、IDE 配置、临时数据……这些东西如果一不小心提交上去，不仅污染仓库，还会给团队带来不必要的麻烦。Git 为此提供了一套灵活又强大的忽略机制，而其中最常见的两个选项，就是 .gitignore 和 .git/info/exclude。

如果你用过 JetBrains 系列 IDE（比如 IntelliJ IDEA、PyCharm、WebStorm 等），一定在 Commit 窗口里见过这个场景：右键点击一个未跟踪文件，弹出两个选项——Add to .gitignore 和 Add to .git/info/exclude。两者都能让文件“消失”在 Git 的追踪列表里，但背后的逻辑和使用场景完全不同。选错了，轻则导致团队配置文件混乱，重则可能把不该暴露的东西推上远程仓库。今天就来把这俩东西彻底掰扯清楚。

一、Git 忽略机制概述

Git 的忽略功能，本质上就是一套模式匹配规则。你可以指定文件路径或者通配符，告诉 Git：“这些文件，别管它们，也别提醒我提交。” 不过要注意，这套规则只对未跟踪文件（untracked files）生效，已经 tracked 的文件，哪怕你写上忽略，Git 依然会继续跟踪。

Git 的忽略配置是分层级的，优先级从低到高分别是：

• 系统级忽略——通过 core.excludesFile 配置
• 仓库级忽略——项目根目录或子目录里的 .gitignore 文件
• 本地仓库私有忽略——.git/info/exclude
• 命令行临时忽略——比如 git add -f 强制添加

这其中，.gitignore 和 .git/info/exclude 是开发者日常接触最多的两种形式，也是本文要深入对比的核心。

二、.gitignore：项目级共享忽略规则

2.1 定义与位置

.gitignore 是个普通文本文件，通常放在 Git 仓库的根目录下，当然你也可以在任意子目录里放一个。它的作用范围就是所在目录及其所有子目录。举个例子：

my-project/
├── .gitignore ← 作用于整个项目
├── src/
│ └── .gitignore ← 仅作用于 src/ 及其子目录
└── docs/

2.2 核心特性

特性	说明
是否被 Git 跟踪	是。.gitignore 本身可以（且通常应该）被提交到仓库
作用范围	整个仓库（或子目录），对所有克隆该仓库的协作者生效
共享性	团队共享。一旦提交，所有协作者都会继承相同的忽略规则
持久性	持久存在于项目历史中，随代码一起演进

2.3 语法规范（简要）

.gitignore 使用标准的 Git 忽略语法，支持通配符（*、、[...]）、目录匹配（以 / 结尾表示目录）、否定规则（以 ! 开头）、注释（#）以及空行（被忽略）。例如：

# 编译输出
/target/
/build/
*.class
*.o

# 日志文件
*.log

# IDE 配置（根据团队约定决定是否忽略）
.idea/
*.iml
# 但保留特定配置
!.idea/runConfigurations/

2.4 适用场景

什么时候该用 .gitignore？ 一句话：只要这个忽略规则对团队中所有人都适用，就交给它。

• 构建产物（node_modules/、dist/、out/、target/）
• 通用开发工具生成的元数据（比如 .vscode/、.idea/——如果团队约定不提交的话）
• 操作系统或编辑器生成的临时文件（.DS_Store、Thumbs.db、*.swp）
• 敏感信息模板（比如 config.example.yaml，而不是真实配置）
• 所有具有普适性和长期性的忽略规则

最佳实践：把 .gitignore 当作项目文档的一部分来维护，内容要清晰、准确、可审计。

三、.git/info/exclude：本地私有忽略规则

3.1 定义与位置

.git/info/exclude 藏在 Git 仓库内部的 .git 目录里：

/.git/info/exclude

注意，.git 本身是隐藏目录，这个文件不会被 Git 跟踪，也不会出现在工作区文件列表中。

3.2 核心特性

特性	说明
是否被 Git 跟踪	否。属于 Git 内部元数据，永远不会被提交
作用范围	仅限当前本地仓库
共享性	完全私有，其他协作者无法感知
持久性	仅在当前克隆副本中有效；重新克隆仓库，规则就会丢失

3.3 语法规范

语法与 .gitignore 完全一致，支持相同的通配符、否定规则、注释等。比如：

# 仅我本地需要忽略
my-debug-notes.txt
temp-data/
local-config.json

# 临时实验文件
experiment-*.py

3.4 适用场景

什么时候该用 .git/info/exclude？ 一句话：当这个忽略规则只对你个人有意义，且不适合污染项目配置时。

• 你个人临时创建的文件（调试脚本、笔记、草稿）
• 本地 IDE 的个性化配置（比如你修改了 .idea/workspace.xml，但不想影响团队）
• 短期实验或测试产生的大量临时文件
• 避免污染项目的 .gitignore（例如某个规则只对你有意义）
• 处理一个你不具备写权限的开源项目，但仍想本地忽略某些文件

不过话说回来，如果你发现自己频繁使用 .git/info/exclude，可能意味着你的工作流存在优化空间——比如是否该用更规范的临时目录？

四、区别对比表

维度	.gitignore	.git/info/exclude
文件位置	项目工作区（如 ./.gitignore）	Git 内部（./.git/info/exclude）
是否被 Git 跟踪	是（可提交）	否（永不提交）
作用范围	项目级（可递归子目录）	本地仓库级（全局于该仓库）
共享性	团队共享	仅本地私有
持久性	随项目历史持久存在	仅在当前克隆中有效
适用对象	所有协作者	仅当前开发者
典型用途	构建产物、通用工具文件	个人临时文件、本地配置
IDE 支持	所有 Git 客户端均支持	大多数客户端支持（包括 IDEA）

五、常见误区与注意事项

5.1 误区一：“加了忽略就能删除已跟踪的文件”

错误：如果一个文件已经被 Git 跟踪（也就是曾经被 git add 并提交过），那么即使你把它加入 .gitignore 或 exclude，Git 仍然会继续跟踪它。

正确做法：先执行 git rm --cached （或 git rm -r --cached ）停止跟踪，再添加忽略规则。

5.2 误区二：“.gitignore 可以忽略所有文件”

错误：.gitignore 只对 untracked files 有效。已跟踪、已暂存、已提交的文件，忽略规则一概不管。

5.3 优先级问题

Git 在判断是否忽略一个文件时，按这个顺序应用规则（后定义的规则优先级更高）：

• 全局忽略（core.excludesFile）
• 项目 .gitignore
• .git/info/exclude
• 命令行强制操作（如 git add -f）

所以，.git/info/exclude 可以通过否定规则或更具体的匹配来覆盖 .gitignore 中的设置。

5.4 子目录 .gitignore 的作用域

子目录中的 .gitignore 只影响该目录及其子目录，不会影响父目录或其他分支目录。这是实现模块化忽略的有效手段。

六、JetBrains IDEA 中的操作建议

在 IntelliJ IDEA 的 Git Commit 窗口中，选择很简单：

• 如果你希望团队所有人都忽略该文件 → 选择 “Add to .gitignore”
• 如果你仅希望自己本地忽略，且不想影响项目配置 → 选择 “Add to .git/info/exclude”

小技巧：通过 View → Tool Windows → Project 可以显示隐藏文件，然后手动编辑 .gitignore；而 .git/info/exclude 则需要通过终端或文件管理器去访问。

七、扩展：全局忽略（Global Ignore）

除了上述两种方式，Git 还支持全局忽略文件，适用于你机器上的所有本地仓库：

# 设置全局忽略文件路径
git config --global core.excludesFile ~/.gitignore_global

# 编辑 ~/.gitignore_global
echo ".DS_Store" >> ~/.gitignore_global
echo "Thumbs.db" >> ~/.gitignore_global

这很适合放置操作系统级或个人偏好的通用忽略项。不过 IDE 的右键菜单通常不提供这个选项，需要手动配置。

八、最佳实践

场景	推荐方式
团队通用的构建产物、日志、临时文件	.gitignore
开源项目标准忽略（如 GitHub 提供的模板）	.gitignore
个人临时文件、调试输出	.git/info/exclude
本地 IDE 配置（不确定是否共享）	谨慎评估：若团队无统一规范，可用 .git/info/exclude
敏感配置文件（如数据库密码）	不应提交，也不应放在 .gitignore 中暴露路径；应使用环境变量或外部配置管理

几个实用的建议：

• 项目初始化时就创建 .gitignore，可以到 github/gitignore 找现成模板。
• 定期审查 .gitignore，避免过度忽略或遗漏关键文件。
• 不要将个人临时文件规则加入 .gitignore，以免污染项目配置。
• 对于已跟踪文件，先 git rm --cached 再加忽略。
• 团队应就 IDE 配置文件的处理达成一致（比如是否提交 .idea/ 的部分子目录）。

结语

弄明白 .gitignore 和 .git/info/exclude 的区别，表面上看只是 Git 的一个小细节，但实际上它直接关系到团队协作效率和仓库整洁度。合理使用这两种机制，既能保证项目的一致性，又能保留个人开发的灵活性。

记住一句话：

“.gitignore 是给团队用的，.git/info/exclude 是给你自己用的。”

善用忽略规则，你的 Git 仓库会更干净、更专业、也更高效。