如何设置 git 项目以使用外部存储库子模块？

Question

我想创建一个拉入远程存储库的存储库。

例如，假设 jQuery 作为子模块：

git://github.com/jquery/jquery.git

使用 jQuery 作为子模块创建存储库并将我自己的外部添加为远程存储库的过程是什么。

另外，一旦设置完毕，如果我推/拉到我自己的遥控器，外部设备会保持不变吗？

Answer 1

1. 您有一个项目 - 称之为 MyWebApp ，它已经有一个 github 存储库
2. 您想在项目中使用 jquery 存储库
3. 您希望将 jquery 存储库拉入您的项目中一个子模块。

子模块确实非常容易引用和使用。假设您已经将 MyWebApp 设置为存储库，请从终端发出以下命令：

cd MyWebApp
git submodule add git://github.com/jquery/jquery.git externals/jquery

这将创建一个名为 externals/jquery* 的目录，并将其链接到 github jquery 存储库。现在我们只需要初始化子模块并将代码克隆到其中：

git submodule update --init --recursive

您现在应该将所有最新代码克隆到子模块中。如果 jquery 存储库发生更改并且您想要下载最新的代码，只需再次发出 submodule update 命令即可。请注意：我的项目中通常有许多外部存储库，因此我总是将存储库分组在“externals”目录下。

在线 Pro Git Book 提供了一些关于子模块（以及一般的 git）的好信息以易于阅读的方式。另外，git help submodule 也会提供很好的信息。或者查看 git wiki 上的 Git 子模块教程。

我注意到这篇博客文章讨论了子模块并将它们与 Subversion 的 svn:externals 机制进行了比较： http ://speirs.org/blog/2009/5/11/understanding-git-submodules.html

_{* 作为最佳实践，您应该始终将子模块放在它们自己的目录中，例如Externals。如果不这样做，您的根项目目录很快就会变得非常混乱。}

Answer 2

您需要了解的大部分内容已经得到解答，因此我不会费心解决这个问题，但是，我发现了一小部分通常会丢失的信息。

如您所知，“git pull”不会更新子模块，“git submodules update”也不会下载这些子模块的最新 HEAD。

要将所有子模块更新到最新的上游版本，您可以使用

git submodule foreach git pull

如果您经常更改子模块，并且有很多子模块，那么“git foreach”将变得非常有用。

Answer 3

我认为@Hugo 的答案可能就是您所需要的并且工作正常。所以我找到了一种更简单的方法。

git submodule update --remote

就这样。

所以一个完整的工作流程可能是：

git clone project-with-submodules
git submodule init
git config -l
git submodule update --remote