Git 删除远程分支上的文件

项目里有些文件不该提交到远程仓库，比如 .env、node_modules/、编译产物、IDE 配置文件。已经推上去了怎么办？用 git rm 从跟踪中移除，再推一次就行。

关键区别：git rm 会同时删除本地文件和 Git 跟踪，git rm --cached 只取消跟踪但保留本地文件。大多数场景你要的是后者。

删除单个文件

git rm --cached .env
git commit -m "remove .env from tracking"
git push origin main

执行完后 .env 还在你本地磁盘上，但远程仓库里已经没了。其他人 pull 之后本地的 .env 也会被删除，提前通知一下。

删除整个目录

git rm --cached -r node_modules/
git commit -m "remove node_modules from tracking"
git push origin main

-r 是递归删除，目录必须加这个参数。

删除后加 .gitignore 防止再次提交

光删不够，下次 git add . 又会把文件加回来。删完之后马上更新 .gitignore：

git rm --cached .env
echo ".env" >> .gitignore
git add .gitignore
git commit -m "remove .env and add to gitignore"
git push origin main

这两步合成一次提交比较干净。

批量清理已跟踪但应该忽略的文件

如果 .gitignore 早就写好了，但之前的文件已经被跟踪了，可以一次性全部清理：

git rm -r --cached .
git add .
git commit -m "re-track files respecting gitignore"
git push origin main

第一行取消所有文件的跟踪，第二行重新添加（这次会尊重 .gitignore），效果是把所有应该忽略的文件从跟踪中移除。

这个操作的 diff 会很大（所有文件都会显示为删除再添加），但实际内容没变，只是跟踪状态变了。在多人协作的仓库里操作前跟团队说一声。

如果想连本地文件一起删

不加 --cached 就行：

git rm config/secrets.json
git commit -m "delete secrets.json"
git push origin main

本地和远程都会删除，不可逆，确认不需要了再用。

删除指定远程分支上的文件

如果要删的文件在某个特定分支上：

git checkout feature-branch
git rm --cached dist/bundle.js
git commit -m "remove build artifact from feature-branch"
git push origin feature-branch

先切到目标分支，操作方式一样。

常见坑

git rm --cached 之后如果没提交就切分支，改动会带到新分支上去。养成删完立刻提交的习惯。

已经推到远程的敏感信息（密钥、密码），光 git rm 不够，历史提交里还有。需要用 git filter-repo 或 BFG Repo-Cleaner 彻底清除历史记录，然后 force push。这个操作会改写所有人的提交历史，是最后手段。

速查

• 删远程、保本地：git rm --cached <file>
• 删远程、删本地：git rm <file>
• 删目录：加 -r
• 批量按 .gitignore 清理：git rm -r --cached . && git add .
• 删完记得更新 .gitignore 再提交