Git如何忽略已加入的文件

在使用 Git 的过程中，很多人都会遇到这样一个问题：

.gitignore 写好了，但文件还是被提交了？

其实原因很简单——

• .gitignore 只能忽略“未被 Git 跟踪的文件”
• 已经 git add 或提交过的文件，不会自动生效

下面从原理到正确做法，再到常见场景和排坑技巧，一次讲清。

一、问题本质：为什么 .gitignore 不生效？

Git 中文件有两种状态：

• ❌ 未跟踪（untracked）：.gitignore 生效
• ✅ 已跟踪（tracked）：.gitignore 不生效

一旦执行过：

git add file
git commit

这个文件就进入了 Git 的索引（index），之后再写 .gitignore，Git 会直接忽略你的忽略规则。

二、标准解决方案（最常用）

目标很明确：

• 保留本地文件
• Git 不再跟踪
• 以后也不会再被提交

Step 1：在 .gitignore 中添加规则

例如忽略 config.yaml：

config.yaml

Step 2：从 Git 索引中移除（不删本地文件）

git rm --cached config.yaml

注意：--cached 这个参数非常关键——它不会删除你磁盘上的文件。

Step 3：提交修改

git commit -m "ignore config.yaml"

至此完成 ✅

三、忽略整个目录（日志 / 构建产物）

常见场景：logs/、build/、dist/、node_modules/ 等。

.gitignore 中写：

logs/
build/

移除索引：

git rm -r --cached logs build
git commit -m "ignore logs and build directories"

四、已经误加了一堆文件？一口气清理

如果已经提交了 .env、本地配置、构建产物……可以用重建索引法（慎用但非常有效）：

git rm -r --cached .
git add .
git commit -m "reapply .gitignore rules"

这个命令做了什么？清空 Git 索引 → 按新的 .gitignore 规则重新添加 → 本地文件不会丢。

五、只想自己忽略，不影响仓库？

有些文件不想提交，但也不想改 .gitignore（例如 IDE 配置）。这时可以用本地忽略文件：

.git/info/exclude

写法与 .gitignore 完全一致：

.idea/
.vscode/

特点：只对你本地生效，不会提交到仓库。

六、排坑神器：为什么这个文件没被忽略？

怀疑规则没生效时，用这个命令：

git check-ignore -v config.yaml

输出会提示：命中了哪条规则、来自哪个 ignore 文件、路径是否正确。这是高级 Git 使用者必备命令。

七、常见坑位汇总

八、如果文件已经进了 Git 历史（敏感信息）

.gitignore 无法删除历史记录。如果误提交了 token、key、密码、内部配置，需要使用 git filter-repo（推荐）或 BFG Repo Cleaner。并且——立刻作废旧密钥，重新生成凭证。这已经是安全问题，不只是 Git 问题了。

九、总结一句话

.gitignore 管未来，git rm --cached 处理过去。只要记住这一点，90% 的 Git 忽略问题都能解决。