首页/开发/Git 与协作速查/.git/info/exclude 本地私有忽略
Git 基础与命令88 条

.git/info/exclude 本地私有忽略

只在当前克隆生效的忽略清单,适合「仅我不想提交」的临时文件;不随仓库分发,优先级低于目录内的 .gitignore。

Git 与协作速查开发更新于 2026-10-13

本地私有忽略清单

只对当前克隆生效的忽略清单,文件位于仓库管理目录下。它适合「只有我不想提交」的临时文件:不进仓库、不随克隆分发,优先级低于目录内的忽略清单,也不会影响同事的行为。

基本信息

用途本地私有忽略规则,仅当前克隆生效
文件位置仓库管理目录下的排除文件
优先级命令行规则最高,其次是目录忽略清单,再是本文件,最后是全局个人清单
适用内容个人调试文件、临时笔记、本机脚本
分发特性不会随克隆复制到别人的机器上

典型使用场景

  • 个人调试脚本或临时数据文件
  • 不适合写进团队忽略清单的本机产物
  • 临时验证用的测试文件
  • 只有自己使用的编辑器配置
  • 还没决定是否纳入版本控制的试验目录

常用示例

常用示例
echo 'local-notes.md' >> .git/info/exclude   # 追加一条本地忽略规则
git check-ignore -v local-notes.md           # 验证命中的来源文件与行号
git status --ignored                         # 查看当前被忽略的文件
git status                                   # 确认本地文件不再出现在待提交列表

忽略清单优先级

优先级清单
最高命令行传入的排除规则
较高目录内的忽略清单
较低本仓库的本地排除文件
最低全局个人忽略清单
排查忽略优先级时从离文件最近的规则看起:同目录的忽略清单胜过上级目录与本地排除文件。
它不会克隆到别人机器上,团队需要共享的规则必须写进仓库忽略清单,否则同事依然会看到并提交这些文件。
规则冲突时按优先级裁决,用带来源输出的检查命令确认实际命中的是哪一条,比自己推算更可靠。
本地排除文件只影响当前仓库,换一个克隆就失效;长期需要忽略的内容应上提到仓库级清单。

易错点

  • 把团队共用的忽略规则写进本地排除文件,同事依然会把文件提交进来,白折腾一场
  • 与仓库忽略清单冲突时按优先级裁决,误判成规则失效,先用检查命令确认命中来源
  • 删除仓库管理目录下的排除文件会丢掉规则记录,整理时应把有效规则上提到仓库清单
  • 在多个克隆里各写一份本地排除文件,规则逐渐分叉,排查忽略问题时无从统一

数据来源与参考

  • Git 官方文档:gitignore(.git/info/exclude 说明)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌