如何让 `git clone --recursive` 重新创建子模块的遥控器和分支？

Question

我有一个包含几个子模块的项目。其中许多是从 GitHub fork 克隆的，我为我的自定义模块添加了一个分支。典型的设置是这样的：

在本地文件夹中：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 我的项目开始了一个新的衍生项目，当它开始递归时，它吐出一个错误，声称它找不到这些存储库的存储提交。经检查，似乎尚未添加遥控器，并且分支在 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)

唯一的补救办法是手动将遥控器添加到所有存储库（非常乏味）。

在上面有两个跟踪分支但只有一个远程（origin => my github fork）的情况下存在类似的问题。在这种情况下，它会找到提交并将其签出，但无法重新创建跟踪分支，留下一个“悬空”提交......非常可怕，因为它没有警告你！

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

Answer 1

git clone --recursive 等价于git submodule update --init --recursive。

git submodule update 只会签出记录的 SHA1（记录在父仓库中）：

更新已注册的子模块，即克隆缺少的子模块并检查包含存储库的索引中指定的提交。
这将使子模块 HEAD 分离。

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

---

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

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

---

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

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

它吐出一个错误，声称找不到这些存储库的存储提交。

每次在子模块中提交时，您需要：

• 将其推送到关联的远程（即记录在父仓库的.gitmodules 中的远程）
• 返回父 repo 并提交父 repo。

但是：

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

---

2014 年 8 月更新 (Git 2.1)

见commit 9393ae7Matthew Chen (charlesmchen)：

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

“git submodule sync”命令支持--recursive 标志，但文档没有提到这一点。
该标志很有用，例如在子模块的子模块中更改远程时。

---

更新 Git 2.23（2019 年第三季度）

您还可以考虑git clone --recurse-submodule --remote-submodules：它将使用已在其跟踪分支而不是其 gitlink 父 repo SHA1 签出的子模块进行克隆。