接手老旧项目不用改公共gitignore:用git exclude静默忽略AI配置文件
接手维护年代久远的历史项目时,很多人会借助 Coding Agent (例如Claude Code,Codex)生成 CLAUDE.md、AGENT.md,用来定制本地代码辅助规则。
这类文件只服务于我个人本地AI开发,不需要同步给团队、不能提交到远程仓库。但历史仓库的 .gitignore 是团队统一维护的,随意新增规则会打乱原有规范,不适合修改;全局gitignore又会让所有项目都屏蔽这两个文件,灵活性太差。
这时最佳方案:使用 git exclude。
极简使用步骤
- 进入项目根目录,创建对应目录(不存在则自动新建)
mkdir -p .git/info
- 编辑私有忽略文件
.git/info/exclude,写入两行规则
CLAUDE.md
AGENT.md
保存后即时生效,无需额外Git命令。
核心优势
- 文件存放在
.git目录内,不会被Git追踪、推送远程,仅当前本地这份仓库生效; - 全程不动仓库里任何公开文件,
.gitignore零改动,不会影响团队所有人; - 语法和gitignore完全一致,上手无学习成本。
简单选型对比
- 项目
.gitignore:改公共配置,全员生效,适合团队通用文件,此处不合适; - 全局gitignore:全电脑所有仓库统一屏蔽,会误伤其他需要保留CLAUDE.md的项目;
- git exclude:单仓库、个人私有屏蔽,完美适配本地AI配置。
结尾小结
所有仅自己使用、不方便改动团队忽略清单的本地文件,优先交给git exclude管理。