如何在Git中保留文件但不保留其历史记录？

核心注意事项 #

这个操作会重写仓库的全部提交历史，如果是多人协作仓库，务必提前通知团队成员后续需要重新克隆仓库；操作前一定要备份整个仓库目录，避免数据丢失。

推荐方法：使用git filter-repo（官方推荐替代旧工具） #

git filter-repo是Git官方主推的历史重写工具，比旧的filter-branch更高效可靠。

1. 备份文件最新版本
   先把目标文件的最新版本导出到仓库外的临时位置：

git show HEAD:<你的文件名> > /tmp/temp_file

2. 移除该文件的所有历史记录
   执行命令过滤掉所有包含目标文件的历史提交：

git filter-repo --path <你的文件名> --invert-paths

3. 恢复最新版本文件并提交
   把临时备份的文件放回原位置，完成提交：

mv /tmp/temp_file <你的文件名>
git add <你的文件名>
git commit -m "保留<你的文件名>最新版本，移除历史记录"

4. 强制推送到远程仓库（若需同步）
   因为历史已被重写，需要强制覆盖远程仓库：

git push --force origin <你的分支名>

不推荐的旧方法：git filter-branch #

如果无法使用git filter-repo，可以尝试旧的filter-branch，但它处理大仓库速度极慢且易出问题：

git filter-branch --tree-filter 'rm -f <你的文件名>' HEAD

执行完后同样需要恢复最新版本文件、提交并强制推送。

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