37、Git 子模块与子树使用指南

Git 子模块与子树使用指南

在使用 Git 进行项目管理时，子模块（Submodules）和子树（Subtrees）是两种常用的将子项目集成到主项目中的方法。下面将详细介绍它们的使用、问题及解决方法。

子模块的使用与问题

子模块允许你在一个 Git 仓库中包含另一个 Git 仓库。当你更新子模块到其远程仓库的最新内容时，主项目（Superproject）中记录的子模块原始引用（SHA1 值）可能不会自动更新，这可能会导致问题。

1. 子模块更新与主项目引用不同步

当子模块更新后，主项目可能仍认为子模块指向旧的位置。例如：

$ git submodule foreach 'echo $name $sha1' Entering 'mod1' mod1 8add7dab652c856b65770bca867db2bbb39c0d00 Entering 'mod2' mod2 7c2584f768973e61e8a725877dc317f7d2f74f37

此时如果运行git submodule update（不带--remote选项），Git 会将子模块更新到主项目中当前记录的引用，可能会导致子模块回退版本。

$ git submodule update Submodule path 'mod1': checked out '8add7dab652c856b65770bca867db2bbb39c0d0