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 使用者必备命令。

七、常见坑位汇总

现象	原因
.gitignore 不生效	文件已被跟踪
删了 .gitignore 仍被忽略	.git/info/exclude 或全局 ignore
CI 还能看到文件	已提交到历史
新同事 clone 后还有文件	历史里已存在

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

.gitignore 无法删除历史记录。

如果误提交了：

• token
• key
• 密码
• 内部配置

需要使用：

• git filter-repo（推荐）
• 或 BFG Repo Cleaner

并且：

• 立刻作废旧密钥
• 重新生成凭证

这是安全问题，不只是 Git 问题。

九、总结一句话

.gitignore 管未来，git rm --cached 处理过去

只要记住这一点，90% 的 Git 忽略问题都能解决。