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

作者：袖梨 2026-06-08

前言

在日常使用 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 表示不忽略该文件）
注释：以 # 开头
空行：被忽略

示例：

# 编译输出/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 完全一致，支持相同的通配符、否定规则、注释等。

示例：

# 仅我本地需要忽略my-debug-notes.txttemp-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 <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 还支持全局忽略文件，适用于所有本地仓库：

# 设置全局忽略文件路径git config --global core.excludesFile ~/.gitignore_global# 编辑 ~/.gitignore_globalecho ".DS_Store" >> ~/.gitignore_globalecho "Thumbs.db" >> ~/.gitignore_global

这适合放置操作系统级或个人偏好的通用忽略项。但 IDEA 的右键菜单通常不提供此选项。

八、最佳实践

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

最佳实践