将 Git 子树转换为子模块

Question

我确信 git 子树不适合我的项目，我想将我的 git 子树结构转换为 git 子模块。我怎样才能做到这一点？ 有一个结构：

main-repo
│   index.js
│   package.json   
│
└───vendor
    └───subtree-repo
        │   index.js
        │   package.json

Answer 1

也许删除目录然后添加子模块？

git rm vendor/subtree-repo
git submodule add git@github.com:blah/subtree-repo.git vendor/subtree-repo/

Answer 2

虽然看起来答案显然正是 Omar Jackman 所建议的——而且我认为这些步骤没有任何问题——但它确实给你留下了一段可能不太理想的历史。特别是，我假设如果您希望将 vendor 目录移动到其自己的存储库中，那么某些团队将直接使用该新存储库。如果您希望他们拥有完整的历史记录，还有另一个步骤。

该步骤是将git filter-branch 与--subdirectory-filter 一起使用。类似于

git clone path/to/old_repo vendor_repo
cd vendor_repo
git remote remove origin
git filter-branch --subdirectory-filter vendor --prune-empty -- --all

然后验证结果； vendor_repo 应包含在 vendor 中发生的更改的完整历史记录。如果它看起来不错，你可以清理它。 （您可能想要删除 filter-branch 创建的备份 refs、reflog 以及仍然混乱的 vendor-repo 现在无法访问的提交；在这里重新克隆可能是一个不错的捷径。

所以现在你实际上有一个 repo 可以在 Omar 推荐程序的第二步中使用。

您仍然应该将供应商历史记录保留在父 repo 中，因为正确地将正确的子模块提交引用替换为每个历史父 repo 提交对我来说听起来一点也不有趣。我不是说不能做；您需要捕获父仓库提交到供应商仓库提交的映射，然后使用该映射来驱动 --tree-filter 或类似的东西。但是这样做有那么多好处吗？

无论哪种方式，您都可以轻松地将vendor 替换为当前的子模块提交并继续使用该子模块。