如何“ git clone”包括子模块？

#1 楼

在Git 2.13和更高版本中，可以使用--recurse-submodules代替--recursive：

git clone --recurse-submodules -j8 git://github.com/foo/bar.git
cd bar

编者注：-j8是可选的性能优化，在2.8版中可用，并且一次最多可并行获取8个子模块—请参阅man git-clone。

使用1.9版的Git直到版本2.12（-j标志仅在2.8+版中可用）：

git clone --recursive -j8 git://github.com/foo/bar.git
cd bar

在Git 1.6.5及更高版本中，您可以使用：

git clone --recursive git://github.com/foo/bar.git
cd bar

对于已经克隆的存储库或较旧的Git版本，用途：

git clone git://github.com/foo/bar.git
cd bar
git submodule update --init --recursive

#2 楼

在子模块将被填充之前，您必须做两件事：

git submodule init 
git submodule update

#3 楼

Git 2.23（Q3 2019）：如果要克隆子模块并将其更新到最新版本：

git clone --recurse-submodules --remote-submodules

如果只想在记录的SHA1上克隆它们：

git clone --recurse-submodules

请参阅下文。
请注意，Git 2.29（Q4 2020）在子模块处理方面带来了重大优化。
请参阅Orgad Shaneh（orgads）提交的commit a462bee（06 Sep 2020）。（由Junio C Hamano合并- -gitster-在2ce9d4e提交中，2020年9月18日）


submodule：禁止检查对象ID的文件名和引用歧义
签名者：Orgad Shaneh


collect_changed_submodules()的argv参数仅包含对象ID（所有引用的对象引用）。​​
通过传递setup_revisions()来通知assume_dashdash,输入不是文件名，这样可以避免冗余每个引用的统计信息。
也禁止使用refname_ambiguity标志以避免每个对象的文件系统查找。在cat-file，pack-objects等中可以找到类似的逻辑。
此更改将我回购中git fetch（man）的时间从25s减少到6s。


原始答案2010
正如joschi在评论中提到的那样，git submodule现在支持--recursive选项（Git1.6.5及更高版本）。

如果指定了--recursive，此命令将递归到已注册的子模块中，并更新其中的任何嵌套子模块。

请参阅init递归使用git子模块。
有关更多信息，请参见git submodule。

版本1.6.5或更高版本。 git及更高版本，您可以通过使用–-recursive选项克隆超级项目来自动执行此操作：

git clone --recursive git://github.com/mysociety/whatdotheyknow.git

用git 2.8更新2016：请参阅“如何加快速度” /使用git clone --recursive并行化git子模块的下载？“
您可以并行使用多个线程来启动获取子模块。
例如：

git fetch --recurse-submodules -j2

甚至更好，使用Git 2.23（Q3 2019），您可以克隆并通过一个命令将子模块检出到其跟踪分支！
请参阅Ben Avison（bavison）提交的commit 4c69101（2019年5月19日）（由Junio C Hamano合并-gitster-在2019年6月17日提交9476094号提交中）


clone：添加--remote-submodules标记


使用git clone --recurse-submodules时以前没有办法
将<43传递给隐式--remote命令用于
您希望将子模块放置在任何情况下已在其
远程跟踪分支上检出，而不是在超级项目中记录的SHA-1检出。


此修补程序纠正了这种情况。
它实际上通过了git submodule update也可以从--no-fetch移植到子模块，因为从子模块刚刚被克隆，所以再次从远程获取仅会减慢速度。

这意味着：

--[no-]remote-submodules:

所有克隆的子模块将使用子模块的远程跟踪分支的状态来更新子模块，而不是超级项目的已记录SHA-1。等效于将git submodule update传递给--remote。

#4 楼

[快速解答]
您可以使用此命令来克隆所有子模块的仓库：

git clone --recursive YOUR-GIT-REPO-URL

或者如果您已经克隆了项目，则可以使用：

git submodule init
git submodule update

#5 楼

如果将子模块添加到分支中，请确保将其包含在克隆命令中...

git clone -b <branch_name> --recursive <remote> <directory>

#6 楼

尝试以下操作：

git clone --recurse-submodules

假设您已经将子模块添加到父项目中，它将自动提取子模块数据。

#7 楼

我认为您可以执行3个步骤：

git clone
git submodule init
git submodule update

#8 楼

[快速解答]
克隆父仓库（包括某些子模块仓库）后，请执行以下操作：

git submodule update --init --recursive

#9 楼

后一个答案

// git CLONE INCLUDE-SUBMODULES ADDRESS DESTINATION-DIRECTORY
git clone --recursive https://USERNAME@bitbucket.org/USERNAME/REPO.git DESTINATION_DIR

我花了整整一个小时摆弄一个朋友：即使您拥有BitBucket的管理员权限，也请始终克隆ORIGINAL存储库并使用密码拥有回购协议的人之一。恼人地发现您遇到了这个陷阱：P

#10 楼

克隆存储库时，可以使用--recursive标志。此参数强制git克隆存储库中所有已定义的子模块。 >

git clone --recursive git@repo.org:your_repo.git

#11 楼

尝试将其包含在git存储库中。

git clone -b <branch_name> --recursive <remote> <directory>

或

git clone --recurse-submodules

#12 楼

子模块并行获取旨在通过一次启用多个存储库来减少获取存储库及其所有相关子模块所需的时间。这可以通过使用新的--jobs选项来实现，例如：

git fetch --recurse-submodules --jobs=4

根据Git团队，这可以大大加快更新包含许多子模块的存储库的速度。在不使用新的--jobs选项的情况下使用--recurse-submodules时，Git将一个接一个地获取子模块。

来源：http://www.infoq.com/news/2016/03/git28发布

#13 楼

对于GitHub存储库，我遇到了同样的问题。我的帐户缺少SSH密钥。该过程是


生成SSH密钥
将新的SSH密钥添加到GitHub帐户

，然后，您可以使用子模块克隆存储库（git clone --recursive YOUR-GIT-REPO-URL ）

或

运行git submodule init和git submodule update以在已克隆的存储库中获取子模块。

#14 楼

如果这是一个新项目，只需执行以下操作即可：

$ git clone --recurse-submodules https://github.com/chaconinc/YourProjectName 

如果已安装，则比：

$ cd YourProjectName (for the cases you are not at right directory) 
$ git submodule init
$ git submodule update

#15 楼

尝试一下。

git clone -b <branch_name> --recursive <remote> <directory>

如果已将子模块添加到分支中，请确保将其添加到clone命令中。