我有一个包含一些子模块的项目。其中许多是从 GitHub 分支克隆而来的，我已经为我的自定义 mod 添加了一个分支。一个典型的设置是这样的:

在本地文件夹:MyProject1/Frameworks/SomeAmazingRepo/

$ git branch -vva
*my-fork                       123456 [my-fork/my-fork] Latest commit msg from fork
master                         abcdef [origin/master] Latest commit msg from original repo
remotes/my-fork/my-fork        123456 [my-fork/my-fork] Latest commit msg from fork
remotes/my-fork/master         abcdef [origin/master] Latest commit msg from original repo
remotes/origin/HEAD            -> origin/master
remotes/origin/master          abcdef [origin/master] Latest commit msg from original repo

$ git remote -v
my-fork                        git@github.com:MyUser/SomeAmazingRepo.git (fetch)
my-fork                        git@github.com:MyUser/SomeAmazingRepo.git (push)
origin                         git://github.com/OriginalOwner/SomeAmazingRepo.git (fetch)
origin                         git://github.com/OriginalOwner/SomeAmazingRepo.git (push)

我 git clone --recursive 我的项目开始一个新的衍生项目，当它开始递归时，它吐出一个错误，声称它找不到这些 repos 的存储提交.经检查，似乎没有添加 Remote ，分支在 master 中保留(空)...

在本地文件夹:MyProject2/Frameworks/SomeAmazingRepo/

$ git branch -vva
*master                        abcdef [origin/master] Latest commit msg from original repo
remotes/origin/HEAD            -> origin/master
remotes/origin/master          abcdef [origin/master] Latest commit msg from original repo

$ git remote -v
origin                         git://github.com/OriginalOwner/SomeAmazingRepo.git (fetch)
origin                         git://github.com/OriginalOwner/SomeAmazingRepo.git (push)

唯一的补救办法是手动将 Remote 添加到所有存储库(非常乏味)。

在有两个跟踪分支但只有一个远程(origin => my github fork)的情况下存在类似的问题。在这些情况下，它找到提交并检查它但无法重新创建跟踪分支，留下“悬空”提交......非常可怕，因为它没有警告你!

如何克隆我的项目，以便它可靠地重新创建子模块的远程和分支？

最佳答案

git clone --recursive 相当于git submodule update --init --recursive .

还有一个 git submodule update只会检查记录的 SHA1(记录在父仓库中):

Update the registered submodules, i.e. clone missing submodules and checkout the commit specified in the index of the containing repository.
This will make the submodules HEAD be detached.

2012:所以在子模块中找不到事件分支是常态。
git submodule foreach 'git checkout master'至少可以设置主分支(如果您确定所有记录的 SHA1 都应该是每个子模块的“主”分支的一部分。

2013-2014:您可以配置您的 .gitmodules文件以指定要在子模块中 check out 的分支。
参见“How do I update my git submodules from specific branches?”

cd /path/to/your/parent/repo
git config -f .gitmodules submodule.<path>.branch <branch>

您在子模块中本地添加的任何 Remote ，例如 my-fork , 根本没有记录在父仓库中。
因此，当您再次克隆该父存储库时，它将初始化并更新子模块，如 .gitmodules 中记录的那样文件(您可以 change that address ，但只有 一个 与每个子模块关联)。
如果您有其他远程地址要关联到每个子模块，则需要一个脚本来自动执行该过程。

如“True nature of submodule”中所述，子模块主要用于记录/访问历史记录中的固定点。
您可以直接在子模块中进行开发，但您需要到那里创建正确的分支和/或添加正确的 Remote 。

it spits out an error claiming it can't find the stored commits for these repos.

每次在子模块中进行提交时，您需要:

• 将其推送到关联的 Remote (即记录在父仓库的 .gitmodules 中的 Remote )
• 返回父仓库并提交所述父仓库。

但是:

如果您已推送到“my-fork” ' 而该子模块的关联远程仓库不是 ' my-fork '... 那么下一个克隆将无法 check out 该子模块提交。

2014 年 8 月更新(Git 2.1)

参见 commit 9393ae7通过 Matthew Chen ( charlesmchen ) :

子模块:文档“sync --recursive”

The "git submodule sync" command supports the --recursive flag, but the documentation does not mention this.
That flag is useful, for example when a remote is changed in a submodule of a submodule.

更新 Git 2.23(2019 年第三季度)

你也可以考虑 git clone --recurse-submodule --remote-submodules : 这将克隆子模块已经在他们的跟踪分支而不是他们的 gitlink 父 repo SHA1 checkout 。

关于git - 如何获取 `git clone --recursive` 以重新创建子模块的 Remote 和分支？，我们在Stack Overflow上找到一个类似的问题： https://stackoverflow.com/questions/10666085/