前言
在日常使用 Git 进行版本控制的过程中，我们经常会遇到一些不需要纳入版本管理的文件，例如编译产物、日志文件、IDE 配置、临时数据等。为了防止这些文件被意外提交，Git 提供了灵活而强大的"忽略机制"（Ignore Mechanism）。
在 JetBrains 系列 IDE（如 IntelliJ IDEA、PyCharm、WebStorm 等）中，当你在 Commit 窗口右键点击一个未跟踪文件时，会看到两个选项：
- Add to .gitignore
- Add to .git/info/exclude
这两个选项都能实现"忽略文件"的目的，但它们在作用范围、共享性、生命周期和适用场景上存在本质区别。
一、Git 忽略机制概述
Git 的忽略功能基于模式匹配规则 （Pattern Matching），通过指定文件路径或通配符，告诉 Git 哪些文件不应被视为"待跟踪"或"待提交"的对象。这些规则不会影响已经 tracked（已纳入版本控制）的文件，仅对 untracked files（未跟踪文件）生效。
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 忽略语法，支持：
- 通配符：
*,?,[...] - 目录匹配：以
/结尾表示目录（如build/） - 否定规则：以
!开头（如!important.log表示不忽略该文件） - 注释：以
#开头 - 空行：被忽略
示例：
gitignore
# 编译输出
/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 仓库内部的一个特殊文件，位于：
<repo-root>/.git/info/exclude注意：.git 是隐藏目录，该文件不会被 Git 跟踪，也不会出现在工作区文件列表中。
3.2 核心特性
| 特性 | 说明 |
|---|---|
| 是否被 Git 跟踪 | 否。该文件属于 Git 内部元数据，永远不会被提交 |
| 作用范围 | 仅限当前本地仓库（Local Repository） |
| 共享性 | 完全私有。其他协作者无法感知或继承这些规则 |
| 持久性 | 仅在当前克隆副本中有效；若重新克隆仓库，规则将丢失 |
3.3 语法规范
语法与 .gitignore 完全一致，支持相同的通配符、否定规则、注释等。
示例：
gitignore
# 仅我本地需要忽略
my-debug-notes.txt
temp-data/
local-config.json
# 临时实验文件
experiment-*.py3.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 仍然会继续跟踪它。
✅ 正确做法：
bash
# 停止跟踪但保留本地文件
git rm --cached <file>
# 或停止跟踪整个目录
git rm -r --cached <directory>之后再添加忽略规则才生效。
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 还支持全局忽略文件，适用于所有本地仓库：
bash
# 设置全局忽略文件路径
git config --global core.excludesFile ~/.gitignore_global
# 编辑 ~/.gitignore_global
echo ".DS_Store" >> ~/.gitignore_global
echo "Thumbs.db" >> ~/.gitignore_global这适合放置操作系统级或个人偏好的通用忽略项。但 IDEA 的右键菜单通常不提供此选项。
八、最佳实践
| 场景 | 推荐方式 |
|---|---|
| 团队通用的构建产物、日志、临时文件 | ✅ .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 仓库更干净、更专业、更高效。
参考资料：