首页/开发/Git 与协作速查/.gitignore 忽略规则
Git 基础与命令88 条

.gitignore 忽略规则

声明无需纳入版本控制的文件:按目录生效、支持通配与否定;忽略规则只对未跟踪文件生效,已跟踪文件需要先移出索引。

Git 与协作速查开发更新于 2026-10-12
匹配规则空行与 # 注释;/ 结尾只匹配目录;! 否定;** 跨目录匹配
生效范围.gitignore 所在目录及其子目录
典型内容构建产物、依赖目录、日志、本地环境文件

示例规则

示例规则
build/
*.log
!important.log
**/node_modules/
.env*
# 忽略 docs 下除 README 外的所有文件
docs/*
!docs/README.md
模式含斜杠时相对 .gitignore 所在目录解析;不含斜杠时匹配任意层级,两种写法侧重点不同。

易错点

  • 父目录整体被忽略后,子目录里的 ! 否定不会生效,需要先放开父目录再逐级否定
  • 已被跟踪的文件不受忽略规则影响,先 git rm --cached 移出跟踪

数据来源与参考

  • Git 官方文档:gitignore(模式格式)
  • Pro Git 2nd Edition · 2.2 忽略文件
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌