.gitignore 速查表 - 忽略规则与写法大全

写 .gitignore 时最容易忘的匹配语法和坑都在这里,按通配、目录、否定、全局分好类,配示例直接复制。

版本控制·共 24 条命令·最后更新 2026-08-02
返回 版本控制

基本语法 Syntax 6

*.log
忽略所有 .log 文件
build/
忽略 build 目录及其内容
/dist
仅忽略根目录下的 dist(不含子目录)
**/node_modules
忽略任意层级的 node_modules
doc/*.txt
忽略 doc 下一级的 .txt(不含子目录)
!keep.txt
否定规则:不忽略 keep.txt

通配与注释 Patterns 6

?
匹配单个任意字符
[abc]
匹配方括号内任一字符
**
匹配任意层级目录
# note
注释行
#file
转义井号以匹配字面 #
!imp
转义感叹号以匹配字面 !

目录与文件 Dirs & Files 4

.cache
忽略名为 .cache 的文件或目录
*.tmp
忽略所有临时文件
logs/*.log
忽略 logs 下一级日志
*.swp
忽略编辑器交换文件

全局与生效 Global 4

git config --global core.excludesfile ~/.gitignore_global
设置全局忽略文件
git check-ignore -v file
查看某文件被哪条规则忽略
git rm --cached file
停止追踪但保留本地文件
git add -f file
强制添加被忽略的文件

常见语言模板 FAQ 4

node_modules/
Node 依赖目录
.env
环境变量(含密钥,务必忽略)
__pycache__/
Python 缓存
.DS_Store
macOS 系统文件

💡 提示

  • 模式匹配相对 .gitignore 所在目录,根目录用 /dist 锚定。
  • 先写否定规则 !file 时,其父目录必须未被忽略。
  • git check-ignore -v file 可查出哪条规则忽略了某文件。
  • 已追踪的文件需 git rm --cached 后才停止追踪。

官方参考来源

命令整理自以下官方文档,点击核对最新用法。

由 LaoHand 维护

公开更新于 2026年8月2日,内容持续校对官方文档。

发现错误?反馈给我们

命令或描述有误?提交 issue 帮助我们修正。

发现错误?反馈给我们