如何从Git仓库历史中移除.env文件及相关提交？

操作前必做：备份仓库 #

• 复制整个本地仓库文件夹到其他位置，避免操作失误导致数据丢失。

方法一：使用git filter-repo（推荐，更安全高效） #

1. 确保已安装git-filter-repo：
   • Ubuntu/Debian：sudo apt install git-filter-repo
   • macOS：brew install git-filter-repo
   • Windows：pip install git-filter-repo（需先安装Python）
2. 在仓库根目录执行命令，重写历史移除.env文件：

   git filter-repo --path .env --invert-paths
   

方法二：使用git filter-branch（旧兼容方案） #

如果无法安装git-filter-repo，可使用此命令（注意：该命令已被官方标记为过时）：

git filter-branch --force --index-filter 'git rm --cached --ignore-unmatch .env' --prune-empty --tag-name-filter cat -- --all

清理本地冗余数据 #

执行以下命令清理重写历史后留下的冗余引用和对象：

git for-each-ref --format='delete %(refname)' refs/original | git update-ref --stdin
git reflog expire --expire=now --all
git gc --prune=now --aggressive

强制推送到GitHub #

由于重写了仓库历史，必须强制推送覆盖远程仓库：

git push origin --force --all
# 如果有标签需要同步，执行：
git push origin --force --tags

后续预防 #

1. 在仓库根目录创建或更新.gitignore文件，添加一行：

   .env
   

2. 提交并推送.gitignore：

   git add .gitignore
   git commit -m "Exclude .env from commits"
   git push origin main
   

注意：如果是团队协作项目，所有成员必须重新克隆仓库，本地旧仓库的历史已失效，继续使用会导致冲突。

内容的提问来源于stack exchange，提问作者Editor Simon