如何将单个文件的提交历史从一个仓库迁移至另一独立仓库？

完全可以实现将类库仓库的所有提交历史迁移到服务仓库，同时保留每一次针对类库文件的修改记录，而非生成单一的合并提交。以下是具体操作步骤：

1. 预处理类库仓库的历史路径 #

因为服务仓库中类库有固定的存放路径（比如./internal/library），需要先将类库仓库的所有提交历史调整为对应路径，避免合并后文件位置混乱：

• 全新克隆类库仓库到临时目录：

  git clone <类库仓库地址> temp-lib-repo
  cd temp-lib-repo
  

• 使用git filter-repo重写所有提交，将类库文件统一移动到服务仓库对应的目录（替换internal/library为你实际的类库存放路径）：

  git filter-repo --to-subdirectory-filter internal/library
  

  这一步会修改类库仓库的每一条提交记录，让所有文件都位于指定子目录下，和服务仓库的类库路径对齐。

2. 将类库历史合并到服务仓库 #

• 回到你的服务仓库本地目录：

  cd ../service-repo
  

• 添加预处理后的临时类库仓库为本地远程：

  git remote add temp-lib ../temp-lib-repo
  

• 拉取临时类库仓库的所有提交历史：

  git fetch temp-lib
  

• 执行跨历史合并（因为两个仓库原本无关联，需要加--allow-unrelated-histories参数）：

  git merge temp-lib/main --allow-unrelated-histories
  

  合并过程中如果出现文件冲突（比如服务仓库原有旧版类库文件），手动解决冲突后提交即可。

3. 验证与清理 #

• 查看合并后的提交历史，确认类库的所有原始提交都被保留：

  git log --oneline --graph
  

• 检查类库文件是否同步到最新版本，功能正常
• 移除临时远程仓库：

  git remote remove temp-lib
  

• 删除临时类库仓库目录：

  rm -rf ../temp-lib-repo
  

• 将合并后的代码推送到服务仓库的远程服务器：

  git push origin main
  

额外提示 #

• 如果类库仓库有多个分支或标签，需要在预处理步骤中对对应分支重复路径调整操作，再分别合并到服务仓库的对应分支
• git filter-repo是Git官方推荐的历史重写工具，比旧的git filter-branch更安全高效，确保你的Git版本在2.22.0以上（若版本过低需升级）
• 操作前建议备份服务仓库和类库仓库的本地副本，避免误操作导致数据丢失

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