如何将旧仓库相关提交合并至新仓库的Git子模块？

我来帮你梳理一下具体的操作步骤，分两种场景处理，确保能准确把旧仓库里修改了子模块对应文件的提交迁移到新仓库的子模块中：

场景1：提交只修改了属于dir2的文件 #

这种情况比较简单，我们只需要提取这些提交，调整文件路径后推送到子模块仓库即可：

步骤1：提取旧仓库的目标提交并调整路径 #

1. 先把旧仓库拉到本地（如果已经有本地副本，直接拉最新代码就行）：

   git clone /path/to/old/repo old-repo
   cd old-repo
   git checkout main  # 切换到包含目标提交的分支，比如main或者你同事推送的分支
   

2. 创建一个临时分支专门用来处理迁移：

   git checkout -b migrate-dir2
   

3. 用git filter-repo调整文件路径——因为旧提交里的文件路径是src/xxx，但这些文件现在在子模块仓库的根目录（或者对应子模块的特定路径，根据你的实际结构调整），所以要把路径前缀改掉：

   # 替换成所有属于dir2的文件/目录路径，--path-rename 把src/前缀换成子模块里的对应路径（这里是空，即根目录）
   git filter-repo --path-rename src/: --paths src/file2 --paths src/file3 --paths src/subdir-for-dir2
   

   提示：如果你的环境还没装git filter-repo，可以用包管理器（比如apt、brew）安装，它是官方推荐替代git filter-branch的工具，更稳定高效。如果实在没法用，也可以用git filter-branch，但要注意备份。

步骤2：把调整后的提交推送到子模块仓库 #

1. 把子模块的仓库地址添加为临时远程：

   git remote add dir2-submodule /path/to/your/dir2-submodule-repo
   

2. 把我们处理好的临时分支推送到子模块仓库的主分支（比如main，根据子模块的实际分支名调整）：

   git push dir2-submodule migrate-dir2:main
   

步骤3：更新新仓库里的子模块引用 #

1. 切换到你的新仓库目录：

   cd /path/to/new-repo
   

2. 更新子模块到最新的提交：

   git submodule update --remote src/src_public/dir2
   

3. 提交子模块的更新到新仓库：

   git add src/src_public/dir2
   git commit -m "Sync dir2 submodule with latest changes from old repo"
   git push
   

场景2：提交同时修改了dir1和dir2的文件 #

如果有些提交既改了dir1的文件又改了dir2的文件，我们需要先拆分这些提交，只保留和dir2相关的修改：

1. 先在旧仓库里创建一个临时分支：

   cd old-repo
   git checkout -b split-commits main
   

2. 用交互式rebase来拆分提交：

   # 替换成第一个需要拆分的提交的父提交哈希值，这样就能编辑从那个提交开始的所有目标提交
   git rebase -i <commit-hash-of-first-target-commit>^
   

3. 在弹出的编辑器里，把需要拆分的提交前面的pick改成edit，保存后退出。
4. 对每个标记为edit的提交，执行以下操作拆分：

   # 撤销当前提交的所有修改，回到提交前的状态
   git reset HEAD^
   # 只添加属于dir2的文件修改
   git add src/file2 src/file3
   # 提交这部分修改，备注可以保留原提交信息并加上拆分说明
   git commit -m "Split: [原提交信息] - dir2 changes"
   # （如果不需要保留dir1的修改，直接跳过下面两步）
   # git add src/file1
   # git commit -m "Split: [原提交信息] - dir1 changes"
   # 继续处理下一个提交
   git rebase --continue
   

5. 拆分完成后，就可以按照场景1的步骤，用git filter-repo调整路径，推送到子模块仓库，最后更新新仓库的子模块。

一些注意事项 #

• 操作前一定要备份所有仓库，避免误操作导致数据丢失！
• 如果子模块仓库的路径结构和旧仓库里的路径不是简单的前缀替换，要调整--path-rename的规则，比如旧路径是src/subdir/file，子模块里是dir2/subdir/file，那就要写成--path-rename src/:dir2/。
• 如果有大量提交要处理，git filter-repo的效率和稳定性远高于git filter-branch，优先用它。

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