如何让 Git 停止跟踪已加入 .gitignore 的文件
文件被跟踪后加入 .gitignore 不生效,需先移出索引:git rm --cached <文件>(目录加 -r),移出索引后匹配的 gitignore 规则立即生效,提交用于共享变更。本地文件不受影响,只是 Git 不再跟踪其变化。
核心动作:git rm --cached <文件> 把它移出 Git 索引(本地文件保留),移出索引后,匹配 .gitignore 的本地未跟踪文件立即被忽略;提交用于共享这个变更。 只加 gitignore 不移索引是没用的——Git 对已跟踪文件永远优先看索引。
操作步骤
# 1. 确保 .gitignore 里已有该文件规则
echo "config.local.json" >> .gitignore
# 2. 移出索引(--cached = 不动磁盘文件)
git rm --cached config.local.json
git rm -r --cached build/ # 目录加 -r
# 3. 暂存忽略规则,检查范围,再提交
git add .gitignore
git diff --cached --stat
git commit -m "停止跟踪本地配置文件"
git push
批量处理所有"应忽略却被跟踪"的文件
git rm -r --cached . # 全部移出索引
git add . # 按 gitignore 重新添加(被忽略的不会进来)
git commit -m "清理索引,对齐 gitignore"
该组合会重建整个索引,并可能暂存无关工作区改动;仅在已核实全部暂存内容且有备份时使用,日常优先逐路径处理。
队友侧的效果
他们 pull 后,该文件在他们机器上也会被"停止跟踪"——但本地文件会被删除(对 Git 来说这是一次删除提交)。提醒队友提前备份自己那份本地配置。
常见问题(FAQ)
Q:--cached 会删本地文件吗?
不会。它只操作索引;不加 --cached 的 git rm 才连文件一起删。
Q:历史提交里的旧版本怎么办?
停止跟踪只影响之后。历史里的旧内容仍在仓库中(含敏感信息的话需要用 git filter-repo 重写历史并作废凭据)。
Q:想让 Git 忽略已跟踪文件的本地改动、但不从索引删除?
skip-worktree 主要服务稀疏工作树,不是可靠的“忽略已跟踪配置修改”方案,切换/合并仍可能处理该文件;更稳妥的是跟踪模板并忽略独立的本地配置。