如何从Git所有提交记录中移除指定文件的跟踪

工具选择 #

使用git filter-repo（官方推荐替代git filter-branch的工具，更安全高效）批量修改整个提交树，无需手动逐个操作提交。

操作步骤 #

1. 安装git filter-repo

   • Linux：通过包管理器安装，比如 sudo apt install git-filter-repo
   • macOS：用Homebrew安装，brew install git-filter-repo
   • Windows：Git for Windows自带该工具，若缺失可下载官方脚本添加到系统PATH

2. 移除敏感文件的所有历史记录
   替换path/to/sensitive-file.txt为你的敏感文件实际路径，执行命令：

   git filter-repo --invert-paths --path path/to/sensitive-file.txt
   

   该命令会遍历所有提交，彻底删除目标文件，同时完整保留其他提交的作者信息、提交时间等内容。

3. 验证修改结果
   查看提交历史确认敏感文件已被移除：

   git log --oneline
   

   也可以检查任意提交中是否还存在该文件：

   git show <commit-hash>:path/to/sensitive-file.txt
   

   若提示“路径不存在”则说明操作成功。

4. 强制推送至GitHub
   由于修改了提交历史，必须强制覆盖远程仓库：

   git push origin --force --all
   

   若仓库包含标签，需要同步标签历史：

   git push origin --force --all --tags
   

注意事项 #

• 若有其他协作者克隆过该仓库，他们需要重新克隆仓库，或执行git fetch origin后用git reset --hard origin/<分支名>同步新历史
• 操作前建议备份原仓库，避免数据丢失
• 不要使用git filter-branch，官方已标记该工具为废弃，存在性能和安全隐患

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