Git中从commit中删除文件方法

Posted on Edited on Views:

在 Git 中从 commit 中删除文件，具体操作取决于该 commit 是否已经推送到远程仓库。

情况一：该 commit 尚未推送（本地分支）

如：lfs大文件推送提示限制等，大文件丢弃。

如果你刚刚提交了代码，还没执行 git push，可以使用 git reset --soft 来撤销提交，修改后再重新提交。

1. 撤销最近的一次提交（保留工作区的文件修改）：

1
2
3
4
git reset --soft HEAD~1
# 可以重复多次，不端撤销最近提交记录
git reset --soft HEAD~1
git reset --soft HEAD~1

2. 从暂存区移除文件：

1
git rm --cached <文件路径>

3. 重新提交：

1
2
git add .
git commit -m "更新后的提交信息"

情况二：该 commit 已经推送（远程分支）

如果代码已经推送到远程，直接修改历史比较危险，但可以使用 git rm 在新的 commit 中删除它。

方法 A：在后续提交中删除（最安全）

如果你只是不想再让这个文件出现在未来的版本中，可以直接删除并提交：

1. 从仓库和本地同时删除文件：

1
git rm <文件路径>

或者仅从仓库删除（保留本地文件）：

1
git rm --cached <文件路径>

2. 提交更改：

1
2
3
git add .
git commit -m "从仓库中移除敏感/不需要的文件"
git push origin <分支名>

方法 B：彻底从历史中清除（高级操作）

如果是因为不小心提交了密码、密钥或敏感隐私文件，仅仅在后续删除是不够的，因为文件仍然存在于 Git 的历史记录中。建议使用 git filter-repo（推荐）或 git filter-branch 工具。

使用 git filter-repo 的步骤（需先通过 pip 安装）：

  1. 安装工具：
1
pip install git-filter-repo
  1. 执行清理：
1
git filter-repo --path <文件路径> --invert-paths
  1. 强制推送到远程：
1
git push origin --force --all

警告：使用 git push --force 会重写远程仓库的历史。如果在多人协作的项目中执行此操作，必须提前通知团队成员，否则会导致其他人的本地仓库与远程仓库产生严重的冲突。

避坑指南

  • .gitignore 的作用：如果是误提交了构建生成的文件（如 .log、.env、node_modules 等），请务必在操作后，将该文件添加到 .gitignore 文件中，防止 Git 下次再次追踪它。
  • 确认路径：执行 git rm 时，请确保路径正确，可以使用 git status 先确认文件状态。