管理自己的代码6——Git 子模块

一、引言

有种情况我们经常会遇到：某个工作中的项目需要包含并使用另一个项目。 也许是第三方库，或者你独立开发的，用于多个父项目的库。 现在问题来了：你想要把它们当做两个独立的项目，同时又想在一个项目中使用另一个，该如何操作呢？

Git 通过子模块来解决这个问题。 子模块允许你将一个 Git 仓库作为另一个 Git 仓库的子目录。 它能让你将另一个仓库克隆到自己的项目中，同时还保持提交的独立。

二、实例演示

1、登陆github，建立远程仓库。

2、填入相应的仓库参数，然后进行建立操作，本示例将建立StarrySkyLibrary，用于为StarrySky项目服务。

3、这是建立后的效果，大家可以通过网址：https://github.com/snmplink/snmplink-StarrySkyLibrary查看。

4、接下来，我们回到本地文件，通过Git Bash启动命令行窗口，先输入去除关联索引命令，命令后半部分是库存放的位置。这样当前Git就不再对Git进行代码控制了。

git rm -r --cached .//01_tutorial//01_turn_on_the_led//lib

5、下面，我们建立子模块，命令如下，建立之前应确保后半部分的文件目录不存在，如果有，可先做重名处理。

git submodule add https://github.com/snmplink/snmplink-StarrySkyLibrary .//01_tutorial//01_turn_on_the_led//lib

6、我们进行git状态查看，命令如下：

git status

7、可看到增加了.gitmodule文件，打开此文件内容如下，其标识了子模块的信息。如果有多个子模块，该文件中就会有多条记录。 要重点注意的是，该文件也像 .gitignore 文件一样受到（通过）版本控制。 它会和该项目的其他部分一同被拉取推送。 这就是克隆该项目的人知道去哪获得子模块的原因。

8、上述完成后，接下来，我们使用VS Code完成，会较为简单，我们打开VS Code，选择源代码管理器，可看到现在有2个版本保护。我们选择相应的版本，按照前述的内容进行管理就好了。

9、接下来我们将会克隆一个含有子模块的项目。 当你在克隆这样的项目时，默认会包含该子模块目录，但其中还没有任何文件。我们可以正确使用下列命令，进行代码克隆。

git clone --recursive https://github.com/snmplink/snmplink-StarrySkyLibrary

10、至此，我们就完成了git子模块的设置工作。