Git exclude 功能解析

在平时的 Git 开发协作中，大家对 .gitignore 肯定都不陌生------不管是 node_modules/ 还是构建产物 dist/，只要往 .gitignore 里一放，命令行和 IDE 立刻就干净了。

但你是否遇到过这种尴尬的场景？

直接改项目的 .gitignore？可能会引发团队争议或污染版本历史。

那么，Git 有没有一种既能忽略文件，又只对我个人本地生效的功能呢？

答案就是：Git exclude。

1. 什么是 Git exclude？

简单来说，exclude 是 Git 内部提供的一个"私有忽略配置文件" 。

在语法上，它和 .gitignore 完全一致 （两者甚至共享同一个官方 gitignore 文档）。只要你会写 .gitignore，你就已经天然学会了如何使用 exclude。

它并不存放在项目的根目录下，而是隐藏在当前仓库的 .git 元数据目录中：

Plaintext

css 复制代码

your-project/
├── .git/
│   └── info/
│       └── exclude  <-- 就是它！
├── src/
└── .gitignore

注意：在某些情况下（例如刚克隆完仓库后），.git/info/exclude 文件或 info 目录可能不会自动创建。如果找不到，你自己直接新建一个名为 exclude 的文件即可。

虽然语法一样，但它们在设计哲学和作用域上有本质不同：

💡 特别提醒 ：因为 exclude 仅对当前这一份本地仓库生效，如果你把同一个项目 Clone 了三份到本地，你在副本 A 的 exclude 里写的规则，在副本 B 和 C 中是不会生效的。

定位：特定于当前项目、但属于你个人习惯的临时/辅助文件。
适用文件：
- 个人专用的自动化脚本（如 Makefile、Taskfile）；
- 个人临时编写的调试代码或测试入口（例如文章作者举例的 zzz_marijke 命令文件）；
- 尚未被团队纳入 .gitignore 的个人环境配置文件（如 docker-compose.override.yml）。
优势：既能保持本地工作区干净，又不会给团队的根目录增加"垃圾配置"。

定位：特定于操作系统或你个人编辑器的全局配置。
适用文件 ：macOS 的 .DS_Store、VS Code 的 .vscode/、JetBrains IDE 的 .idea/ 等。
注意事项 ：不要滥用全局 ignore 。如果你在全局忽略了某个项目其实需要的文件（例如团队通用的 .vscode/launch.json），可能会导致你在提交代码时漏掉重要配置。

优先使用 .gitignore ：只要是对项目协作有益的忽略规则，优先通过 .gitignore 提交给全团队。
善用 exclude 管理临时文件 ：本地调试代码、个人快捷脚本，统统塞进 .git/info/exclude。
结合 gitignore.io：在新建项目时，推荐使用官方模板填充基础语言和框架的忽略规则。
如果同一个规则重复出现 ：当你发现自己在多个项目的 exclude 中重复添加同一种文件（例如某款 IDE 插件产生的日志）时，就该考虑把它迁移到全局 .gitignore 中了。