如何仅从Git历史的指定提交之后删除文件？

当然可以实现这个需求——保留目标文件到某个指定提交的历史，删除该提交之后所有版本中对这个文件的记录。以下是具体操作步骤，基于git filter-repo工具（比旧的filter-branch更高效可靠）：

准备工作 #

• 备份仓库：因为修改Git历史是不可逆操作，先复制整个仓库目录做备份，避免数据丢失。
• 确定分界提交：找到你要保留文件历史的最后一个提交（比如你说的第100个版本对应的提交），记录它的哈希值，记为SPLIT_COMMIT。同时可以用git show SPLIT_COMMIT -- path/to/your/file.txt确认这是最后一个需要保留的版本。

具体操作 #

方法一：用git filter-repo精准修改指定范围的历史 #

在仓库根目录执行以下命令（替换SPLIT_COMMIT和TARGET_FILE为实际值）：

git filter-repo --commit-callback '
# 获取分界提交的哈希字节形式
split_commit_id = b"'"$SPLIT_COMMIT"'"
target_file = b"'"$TARGET_FILE"'"

# 判断当前提交是否在分界提交之后
if commit.parents:
    # 如果是分界提交的直接子提交，或后续提交，删除目标文件
    if commit.parents[0].id == split_commit_id or commit.committed_date > git.get_commit(split_commit_id).committed_date:
        commit.tree = commit.tree.filter(lambda item: item.path != target_file)
'

这个命令会遍历所有提交，仅对SPLIT_COMMIT之后的提交修改——从提交的树中移除目标文件，而分界提交及之前的历史完全保留。

方法二：拆分历史后合并（更直观） #

• 创建保留历史的分支：基于分界提交创建分支，保留文件到该点的完整历史：

  git checkout -b preserved-history $SPLIT_COMMIT
  

• 创建待过滤的分支：回到原分支（比如main），创建分支处理后续历史：

  git checkout main
  git checkout -b filtered-history
  

• 过滤后续历史中的文件：在filtered-history分支上，删除目标文件的所有历史记录：

  git filter-repo --invert-paths --path $TARGET_FILE
  

• 合并两段历史：切换到preserved-history分支，合并过滤后的后续历史（因为两段历史是线性的，用git merge不会有冲突）：

  git checkout preserved-history
  git merge filtered-history --allow-unrelated-histories
  

• 替换原分支：如果需要把修改后的历史替换原分支（比如main），可以强制推送（注意：如果是共享仓库，需要通知所有协作者重新克隆）：

  git checkout main
  git reset --hard preserved-history
  

验证结果 #

• 查看分界提交及之前的历史：git log SPLIT_COMMIT -- path/to/your/file.txt，应该能看到该文件的完整历史到分界点。
• 查看分界提交之后的历史：git log SPLIT_COMMIT..HEAD -- path/to/your/file.txt，应该没有任何关于该文件的记录。

内容的提问来源于stack exchange，提问作者Jose Gómez