唯一可靠做法是git rm --cached，因.gitignore仅对未跟踪文件生效；该命令只从暂存区移除记录、保留本地文件，执行后需提交并更新.gitignore，否则下次add可能重新跟踪。
想让 Git 停止跟踪一个已经提交过的文件，又不删本地文件？唯一可靠做法就是 git rm --cached，其他方式要么无效，要么危险。
为什么 git rm --cached 是必须的
Git 的 .gitignore 只对「未跟踪」文件生效。一旦文件进过 git add 和 git commit，它就变成 tracked 状态，此后往 .gitignore 里加任何规则都完全没用——Git 直接忽略那些行。所以必须先让它“变回未跟踪”，git rm --cached 就是干这事的：只从暂存区（index）移除记录，不动工作区文件。执行后，该文件在 git status 里会显示为 deleted，但它还在你磁盘上，且下次 git add . 也不会自动加回去（前提是 .gitignore 已正确配置）。
git rm --cached 常见失败原因
执行后提示 pathspec 'xxx' did not match any files，说明 Git 根本没在索引里找到这个路径。可能原因包括：
-
xxx从未被git add过，压根不在 tracked 列表里（可用git ls-files | grep xxx验证） - 路径写错：大小写不符（尤其在 Windows/macOS 上）、多写了斜杠（如
src/utils/vssrc/utils）、用了反斜杠但没转义 - 文件刚被
git clean -f清掉，但索引还没刷新 - 你在子目录下执行命令，但没写相对路径前缀（比如在
src/下执行git rm --cached config.js，而它实际在项目根目录）
取消目录跟踪要加 -r，通配符要小心
对目录操作必须加 -r，否则报错或只处理第一层。例如停止跟踪整个 logs/：
git rm -r --cached logs/
注意几点：
- Windows PowerShell 用户写
logs\*时，星号和反斜杠之间不能有空格，否则解析失败 -
git rm -r --cached logs/*不等于git rm -r --cached logs/：前者只匹配logs/下一级文件，后者递归全部 - 如果想排除
src/logs/但误写成logs/，可能连带删掉dist/logs/—— 批量前先用git status --porcelain | grep logs预览影响范围
提交后队友拉取会删他们本地文件
这是最容易被忽略的协作风险。git rm --cached + git commit 在 Git 看来就是一次「删除提交」，其他人 git pull 时，Git 默认同步这个删除动作——哪怕他们本地改过该文件、哪怕你已加了 .gitignore，他们的文件照样被删。这不是 bug，是 Git 保证工作区与历史一致的设计。真正安全的做法只有两个：
- 提前通知所有协作者：这次提交会删掉某个文件，请他们手动备份再拉取
- 改用
git update-index --skip-worktree <file></file>（仅本地跳过检查，不提交，适合临时场景；--assume-unchanged不稳定，不推荐）
别指望靠 .gitignore 或“悄悄提交”绕过这点——Git 不会替你做协调。
