高级忽略规则 (.gitignore)

.gitignore 不仅仅是列出几个文件名那么简单。对于复杂的项目结构，你需要掌握更精细的控制模式，以确保仓库只包含源代码，而不包含构建产物、临时文件或敏感信息。

基本规则回顾

# 忽略所有 .log 文件
*.log

# 忽略 node_modules 目录
node_modules/

# 仅忽略根目录下的 TODO 文件，不包括子目录的 (docs/TODO)
/TODO

** 用于匹配多级目录。

# 忽略任何目录下的 .DS_Store 文件
**/.DS_Store

# 忽略 logs 目录下所有层级的 .log 文件
logs/**/*.log

# 忽略 foo/bar/z, foo/a/b/c/z 等
foo/**/z

这是最强大但也最容易让人困惑的功能。你可以先忽略一类文件，然后用 ! 重新包含其中的一部分。

场景：忽略所有文档，但保留 HTML 文件。

# 忽略所有 doc 目录下的内容
doc/*

# 但不忽略 .html 文件
!doc/*.html

如果父目录被忽略了，默认情况下你无法重新包含其中的文件。 Git 出于性能考虑，一旦忽略了某个目录，就不会再遍历该目录下的内容。但通过正确的规则顺序，你可以实现精细控制。

错误示例：

logs/
!logs/important.log  <-- 无效，因为 logs/ 已经被完全忽略

正确做法：

logs/*               <-- 忽略 logs 下的所有内容（而不是 logs 目录本身）
!logs/important.log  <-- 有效，因为 logs 目录本身还在被扫描

多层嵌套的正确模板（顺序很关键）：

# 忽略 build 目录下的所有内容
build/*
# 但保留 build/keep 目录
!build/keep/
# 忽略 build/keep 下的所有内容
build/keep/*
# 但保留其中的 .gitkeep 文件
!build/keep/.gitkeep

有些文件是特定于你的开发环境的（如 macOS 的 .DS_Store，VSCode 的 .vscode/，IntelliJ 的 .idea/），不应该强制要求项目中的每个人都去忽略它们。

作为系统管理员，你应该配置自己的全局忽略文件。

告诉 Git 使用该文件：

git config --global core.excludesfile ~/.gitignore_global

现在，这些文件在你的所有 Git 仓库中都会被忽略，而不需要污染项目的 .gitignore。

有时候你会发现某个文件明明在 .gitignore 里，却还是被 Git 追踪了，或者相反。

使用 git check-ignore 命令查看是哪一行规则生效了。

$ git check-ignore -v app/build/temp.txt

.gitignore:3:build/    app/build/temp.txt

输出表示：.gitignore 文件的第 3 行 build/ 规则导致了该文件被忽略。

如果一个文件已经被提交到了仓库，稍后你把它加到了 .gitignore，Git 不会自动停止追踪它。你需要手动将其从索引（暂存区）中移除。

# 从暂存区移除文件，但保留在工作区
git rm --cached <filename>

# 重新提交
git commit -m "chore: stop tracking ignored file"