在使用 Git 进行版本控制时，Git 忽略文件（即 .gitignore）是每个开发者必须掌握的配置。它决定了哪些文件或目录不会被 Git 跟踪，从而避免将临时文件、编译产物、敏感信息等误提交到仓库。本文将通过典型场景，逐步讲解 .gitignore 的规则、配置方法以及常见问题。
为什么需要 .gitignore？
在项目开发中，我们经常会遇到以下情况：
- Python 项目中的
__pycache__目录和.pyc文件（Python 官方文档指出这些是缓存文件，不应提交） - Node.js 项目中的
node_modules目录 - IDE 配置文件（如
.vscode/） - 包含数据库密码、API 密钥等敏感信息的
.env文件
如果不忽略这些文件，它们会被 Git 跟踪，导致仓库臃肿、合并冲突频繁，甚至泄露敏感信息。因此，合理配置 .gitignore 是项目健康的基础。
.gitignore 基本语法
.gitignore 文件中的每一行都是一个规则，支持通配符和模式匹配。常见语法如下：
#开头的行为注释*.log匹配所有以 .log 结尾的文件build/匹配 build 目录及其所有内容/doc匹配仓库根目录下的 doc 文件或目录doc/匹配任意层级下的 doc 目录!important.log否定规则，重新包含之前被忽略的文件
需要注意的是，规则匹配的是相对于 .gitignore 文件所在目录的路径。如果 .gitignore 位于子目录中，则规则仅对该子目录生效。
典型场景一：忽略编译产物和缓存
对于 Python 项目，官方文档建议忽略 __pycache__/、*.py[cod] 等缓存文件。对于前端项目，node_modules/ 和 dist/ 是常见的忽略项。以下是一个常见的 .gitignore 示例：
# Python
__pycache__/
*.py[cod]
*.so
# Node
node_modules/
dist/
# IDE
.vscode/
.idea/
这样配置后，这些文件就不会出现在 git status 中，也不会被提交。
典型场景二：忽略敏感信息文件
许多项目会包含配置文件，如 .env，其中存储了密钥、数据库连接等敏感信息。如果不加忽略，提交到远程仓库后，即使删除，历史记录中仍可找到。因此，务必在项目创建时就将 .env 添加到 .gitignore。但有时我们会提供 .env.example 作为模板，此时可以这样写：
.env
!.env.example
这样既忽略了真正的 .env，又保留了模板文件。
典型场景三：全局忽略与个人配置
有些文件是特定于操作系统或开发者的，例如 macOS 的 .DS_Store，Windows 的 Thumbs.db。这些不应该出现在项目的 .gitignore 中，因为其他开发者可能不需要。此时可以使用全局 .gitignore：
git config --global core.excludesfile ~/.gitignore_global
然后在 ~/.gitignore_global 中添加系统级忽略规则。这样所有仓库都会忽略这些文件，但不会影响团队协作。
常见误区：忽略已跟踪的文件
很多开发者会尝试在 .gitignore 中添加已经跟踪的文件，但发现不起作用。这是因为 .gitignore 只对未跟踪的文件生效。如果文件已经被 Git 跟踪，需要先移除跟踪：
git rm --cached <file>
然后提交更改。例如，如果你之前提交了 config.ini，现在想忽略它：
git rm --cached config.ini
echo "config.ini" >> .gitignore
git add .gitignore
git commit -m "Stop tracking config.ini"
注意，git rm --cached 会从仓库中删除文件，但保留本地文件。如果你希望保留本地文件，这是正确的方法。
常见误区：否定规则不生效
有时我们想重新包含某个被忽略的文件，但 ! 规则不生效。这是因为 Git 无法重新包含一个文件，如果它的父目录被忽略了。例如：
build/
!build/important.txt
由于 build/ 被忽略，Git 不会检查其内部文件，因此 !build/important.txt 不会生效。解决方案是忽略所有文件，但重新包含目录和文件：
build/*
!build/important.txt
这样 build/important.txt 会被重新包含。
常见误区：忽略大小写和路径问题
在 Windows 和 macOS 上，文件系统默认不区分大小写，但 Git 会区分。如果 .gitignore 中的规则与文件实际大小写不一致，可能导致忽略失败。建议保持规则与文件系统一致，或使用通配符。另外，路径分隔符在 Windows 上使用反斜杠 ，但 .gitignore 中应使用正斜杠 /。
检查忽略规则
当你不确定某个文件是否被忽略时，可以使用 git check-ignore 命令：
git check-ignore -v <file>
它会显示匹配的规则，帮助你调试。例如：
$ git check-ignore -v config.ini
.gitignore:1:config.ini config.ini
参考资料
延伸阅读