git submodule用法（引用外部仓库）

原文作者：@玄冬Wong

 

如果一个仓库中，引用了几个其他几个仓库，想在更新本次仓库的时候同时更新将其他几个引用仓库，那么可以使用git submodule。

要使用submodule，初始化时貌似只能通过命令行初始化，之后跟新可以通过TortoiseGit客户端来更新。

另外，submodule必须引用整个仓库，无法引用某个仓库的某个子目录。

 

添加

具体操作如下：

1，先打开git-bash命令行，然后定位到需要引用的目录位置，然后执行命令，例如：

git submodule add ssh://admin@127.0.0.1:29418/myproject.git bbbb

这条命令意思是，将远程仓库myproject下载到当前目录的bbbb目录下（bbbb会自动新建）。命令在哪个目录下执行，则bbbb目录相对与哪个目录。

注：如果已经存在.gitmodules文件了，执行add命令时需要添加参数：-f，否则无法add成功，例如：

git submodule add -f ssh://admin@127.0.0.1:29418/myproject.git bbbb

 

2，以后就可以通过TortoiseGit客户端更新了：Git Sync -》 submodule update

 

删除

如果要删除submodule，看了stackoverflow上的问答，发现删除git submodule挺麻烦的，官方还没一个专门的命令来删除submodule（至少到当前2.x版本仍然存在这个问题），需要手动删除，手动删除分三步：

这里假设之前添加的bbbb submodule位置在xxx/yyy/目录下

1，删除.git/config中的submodule配置:

[submodule "xxx/yyy/bbbb"]

url = ssh://admin@127.0.0.1:29418/myproject.git

 

2，删除.gitmodules中的submodule配置:

[submodule "xxx/yyy/bbbb"]

path = xxx/yyy/bbbb

url = ssh://admin@127.0.0.1:29418/myproject.git

 

3，删除.git/modules/bbbb

 在.git/modules/目录下，存放了所有submodule的仓库，删除对应的仓库

 

删除操作参考：

http://stackoverflow.com/questions/19915679/trouble-with-adding-removing-a-git-submodule