Git 实战：彻底删除已被 Git 跟踪的目录，并防止再次提交（超详细）

大家在使用 Git 时应该都遇到过这样的情况明明已经把某个目录加入.gitignore为什么每次git status还是能看到甚至别人 pull 代码后这个目录又回来了。最近正好处理了这个问题这里把整个过程整理下来方便以后自己查也希望能帮到遇到同样问题的朋友。一、为什么.gitignore不生效很多人都会有一个误区只要写进.gitignoreGit 就不会再管理这个目录。实际上并不是。.gitignore只能忽略没有被 Git 跟踪untracked的文件。如果这个目录以前已经执行过git add或者已经提交过git commit那么它已经进入 Git 索引Index。即使后来加入.gitignoreGit 依然会继续跟踪它。所以很多人会看到git status还是不断出现这个目录。二、正确的处理流程整个流程其实只有四步。第一步把目录加入.gitignore例如需要忽略scripts/将它写入对应的.gitignore文件即可。注意如果项目存在多级目录需要根据实际情况把忽略规则添加到对应位置。第二步把目录从 Git 索引移除这一步才是真正关键。情况一本地还要保留如果只是不希望 Git 再管理但本地脚本还需要继续使用git rm -r --cached 目录名例如git rm -r --cached scripts这里的--cached表示仅从 Git 索引删除本地文件仍然保留以后不会再被 Git 跟踪这是开发中最常见的方式。情况二本地也一起删除如果这个目录已经彻底不用了git rm -r --force 目录名例如git rm -r --force scripts这里会从 Git 删除本地目录也一起删除操作前建议确认是否还有需要保留的内容。第三步提交修改完成处理后提交git commit -m chore: 移除目录并加入 gitignore这里使用chore类型比较合适因为不是新增功能feat不是修复 Bugfix属于项目维护常见 Commit Type类型含义feat新功能fix修复 Bugchore项目维护删脚本、改 gitignore、升级依赖等docs文档修改refactor重构不改变功能style格式调整不改逻辑test测试相关第四步推送远程仓库git push至此远程仓库也不会再保存这个目录。以后其他同事拉取代码也不会再次出现。三、如何确认真的成功了建议执行下面几个命令检查。查看当前状态git status -sb查看目录是否仍被 Git 跟踪git ls-files 目录名如果没有任何输出说明已经成功取消跟踪。检查是否命中了.gitignore规则git check-ignore -v 目录名/文件名如果能够看到对应的忽略规则就说明配置已经生效。四、为什么别人 Pull 后目录又回来了如果已经删除了目录但执行git pull之后目录再次出现一般只有一种情况远程仓库或其他分支又把这个目录提交上去了。处理方式很简单git rm -r --force 目录名 git commit -m chore: 再次移除目录 git pull --rebase git push这样就能再次同步删除。五、最容易记住的四条命令如果以后再遇到类似问题只需要记住下面四条命令即可。保留本地文件git rm -r --cached 目录名 git commit -m chore: 移除目录并加入 gitignore git push如果连本地一起删除git rm -r --force 目录名 git commit -m chore: 移除目录并加入 gitignore git push六、总结.gitignore的作用只是忽略未被 Git 跟踪的文件并不会自动取消已经纳入版本管理的内容。正确的处理方式可以总结为一句话先写.gitignore再用git rm --cached或git rm --force取消跟踪最后提交并推送。以后遇到配置文件、日志目录、临时脚本、缓存文件等需要停止版本管理的场景都可以按照这套流程处理避免反复被 Git 跟踪或在团队协作中不断同步回来。