.gitignore 为什么没生效？清理 Git 历史中已跟踪但应被忽略的文件

前言

.gitignore 写好了，但文件还是被提交了？这不是你配置错了，而是 Git 的跟踪机制在起作用。本文用一分钟说清原理和解决方法。

问题

你精心编写了 .gitignore，排除了 node_modules/、.DS_Store 等目录。但 git add -A 之后，这些文件依然出现在暂存区，甚至被 push 到了远程仓库。

原因

.gitignore 只对未跟踪（untracked）文件生效。 如果某个文件或目录已经通过 git add 进入了版本库追踪（tracked），.gitignore 就不再管它了。

换句话说，.gitignore 是一道“门禁”，只管新来的。已经在屋里的人，门禁拦不住。

解决

1. 看看有哪些“漏网之鱼”

git ls-files -i -c --exclude-standard

这个命令列出所有已被跟踪但匹配 .gitignore 规则的文件。先跑一遍，确认范围。

2. 一次性清理

git ls-files -i -c --exclude-standard | xargs git rm --cached
git commit -m "Remove tracked files matching .gitignore"

--cached 参数是关键——它只从 Git 索引中移除文件，硬盘上的文件原封不动。

注意事项

• 操作后，其他协作者 pull 时这些文件会被删除（因为他们那边还是被跟踪状态）。确保这些都是本应被忽略的衍生文件（如 node_modules、编译产物）再进行清理。
• 如果只有一两个文件，直接 git rm --cached <file> 更快，不必上 xargs。

总结

核心记忆点：.gitignore 只管新文件，已跟踪的需要 git rm --cached 手动“退房”。