如何使用git-filter-repo删除Git历史中最早的提交？

为啥你之前的脚本没生效？ #

你要删的ae01e9c是仓库的根提交（最老的那个，没有父提交），之前的脚本问题出在：

• 靠commit.startswith判断提交ID太草率，Git的提交哈希是40位完整串，短哈希可能撞车，而且逻辑上没处理好它的子提交的父指向——子提交原本以它为父，现在得让这些子提交变成新的根提交。
• 没明确跳过那个最早提交本身，光改父指向没用。

两种可行的解决办法 #

方法一：直接用shell命令的commit-filter #

这是最省事的方式，直接过滤掉目标提交，同时自动调整后续提交的父关系：

git filter-repo --commit-filter '
if [ "$GIT_COMMIT" = "ae01e9c" ]; then
    skip_commit "$@"
else
    git commit-tree "$@"
fi'

方法二：Python回调（适合复杂场景） #

分两步操作：先修改子提交的父指向，再跳过目标提交。
先写两个Python脚本：

parent_filter.py

def parent_filter(commit, parents):
    earliest_commit = b'ae01e9c'
    # 把所有指向最早提交的父引用删掉
    return [p for p in parents if p != earliest_commit]

commit_callback.py

def commit_callback(commit):
    # 直接跳过最早的那个提交
    if commit[b'id'] == b'ae01e9c':
        return None
    return commit

然后执行命令：

git filter-repo --parent-filter "$(cat parent_filter.py)" --commit-callback "$(cat commit_callback.py)"

必须注意的点 #

• 先备份仓库！ git filter-repo修改历史是不可逆的，别手抖把仓库搞废了。
• 如果ae01e9c这个短哈希有冲突（比如仓库里有另一个提交开头也是这串），就用完整的40位提交哈希。
• 改完之后推远程必须用git push --force，而且要通知一起用这个仓库的人重新克隆，不然会出现历史冲突。

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