git rm --cached 仅从暂存区移除文件跟踪而不删除本地文件，因git严格区分版本控制与文件管理；若文件已被跟踪，.gitignore对其无效，需先git rm --cached再提交并更新.gitignore。
git rm --cached 为什么不能直接删本地文件
因为 git rm --cached 只从暂存区（index）移除文件跟踪，不碰工作区——这是 Git 区分“版本控制”和“文件管理”的核心设计。你删了 tracked 文件却不加 --cached，Git 就真把它当删除操作提交了；加了，它才只取消跟踪，留着文件继续用。
常见错误现象：git status 显示文件为 deleted，但本地文件没了；或者执行完 git rm xxx 后发现误删，还得从历史里恢复。
- 必须加
--cached才安全取消跟踪 - 如果文件已提交过多次，仅
git rm --cached不够，还得确保后续提交不带它——否则下次git add .又会被重新纳入 - 对目录操作要加
-r：比如git rm -r --cached logs/
.gitignore 里写路径后为什么旧文件还是被跟踪
.gitignore 只影响「未跟踪」的文件。一旦文件已被 Git 记录（即出现在 git ls-files 输出里），再往 .gitignore 加路径也无效——Git 假设你明确想管它。
使用场景：你想把 config.local.js 从版本库中剔除，但又希望它留在项目里供本地运行。
- 先执行
git rm --cached config.local.js - 再在
.gitignore里追加config.local.js（或用通配符如*.local.js） - 最后
git commit -m "stop tracking config.local.js" - 注意：如果
.gitignore写的是/config.local.js（开头带斜杠），它只匹配项目根目录下的该文件；不带斜杠则全局匹配
取消跟踪后别人 pull 还会删他们的本地文件吗
会。只要你在提交中删掉了该文件的记录（即 git rm --cached + commit），其他人 git pull 时，Git 默认行为是同步这个“删除”，他们的工作区对应文件也会被删掉——哪怕那文件在他们本地有修改、哪怕你加了 .gitignore。
性能 / 兼容性影响：这不是 bug，是 Git 的一致性保证。但对团队协作很危险，尤其配置文件、密钥等。
- 提前沟通：改之前告诉队友要删哪个 tracked 文件
- 替代方案：用
git update-index --skip-worktree <file></file>或--assume-unchanged（仅限本地跳过检查，不提交变更，适合临时忽略） -
--skip-worktree更可靠：即使远程删了文件，本地也不会被覆盖或删除
git rm --cached 失败提示 “pathspec did not match any files”
说明 Git 根本没在索引里找到这个路径——可能文件压根没被跟踪过，或者路径写错了（大小写、层级、拼写），也可能文件刚被 git clean 清掉但没更新索引。
常见错误现象：明明 ls 能看到文件，git rm --cached 却报错；或者 git status 里根本没显示它。
- 先确认是否被跟踪：
git ls-files | grep -i "filename" - 检查当前路径是否在 Git 仓库根目录下（
git rev-parse --show-toplevel） - 路径含空格或特殊字符？用引号包住：
git rm --cached "my file.txt" - 文件刚新增但还没
git add？那它属于 untracked 状态，不用rm，直接加.gitignore即可
git add . 或队友拉代码时突然冒出来。
