如何在父仓库所有历史提交中替换子模块旧哈希为新哈希？

前置准备 #

1. 备份仓库：先克隆父仓库的本地副本进行操作，绝对不要直接在正在使用的工作仓库上执行历史重写，避免数据丢失。
2. 安装git-filter-repo：这是Git官方推荐替代git filter-branch的工具，可通过包管理器安装（比如brew install git-filter-repo），或从官方源码编译安装。

具体操作步骤 #

假设子模块旧哈希为xyz456，新哈希为abc123，子模块目录名为my_submodule：

1. 进入克隆好的父仓库本地副本：

cd parent-repo-copy

2. 执行git filter-repo命令，遍历所有提交替换子模块哈希：

git filter-repo --tree-filter '
# 检查当前提交是否包含目标子模块
if [ -e my_submodule ]; then
    # 获取当前子模块的引用哈希（去除可能的前导-符号）
    CURRENT_HASH=$(git submodule status my_submodule 2>/dev/null | awk "{print substr(\$1, 2)}")
    # 如果是旧哈希，替换为新哈希
    if [ "$CURRENT_HASH" = "xyz456" ]; then
        git update-index --add --cacheinfo 160000,abc123,my_submodule
    fi
fi'

后续操作 #

1. 验证结果：执行git log --oneline --submodule查看所有历史提交，确认子模块引用已全部替换为abc123；检出任意旧提交，检查子模块指向是否为新哈希。
2. 强制推送到远程：因为重写了仓库历史，需要强制覆盖远程分支：

git push --force origin main  # 替换main为你的实际分支名

3. 协作者同步：通知所有仓库协作者，废弃原有本地仓库，重新克隆远程仓库，避免历史冲突。

注意事项 #

• 子模块的新哈希abc123必须是已经推送到子模块远程仓库的有效提交，否则父仓库的子模块引用会失效。
• 历史重写后，所有基于旧历史的分支、标签都会失效，需要重新创建或调整。

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