Git submodule实战

http://blog.jqian.net/post/git-submodule.html

使用git管理的项目开发中，如果碰到公共库和基础工具，可以用submodule来管理。

常用操作

例如，

公共库是 lib.git，地址：git@github.com:lib.git；
需要使用公共库的项目是 proj.git，地址：git@github.com:proj.git。

添加

为项目proj.git添加submodule，先进到相应的目录下，然后执行如下命令：

git submodule add git@github.com:lib.git <local path>

其中，<local path>是你期望的目录名。

该命令实际会做三件事情：首先，clone lib.git到本地；然后，创建一个 .gitsubmodule 文件标记submodule的具体信息；同时，更新.git/config文件，增加submodule的地址：

[submodule "lib"]

    url = git@github.com:lib.git

删除

首先，需要删除 .git/config 和 .gitsubmodle 文件里submodule相关的部分，然后执行：

git rm --cached <local path>

才能将submodule的相关文件从你的本地仓库里清理掉。

签出

如果要clone一个附带submodule的项目，submodule的文件不会自动随父项目clone出来（其实只会clone出.gitsubmodle 这个描述文件），还需要执行如下命令取出submodule里的文件：

git submodule init

git submodule update

或者，一条组合命令（同样适用于嵌套submodule的情况）：

git submodule update --init --recursive

修改/更新

可能稍微违反直觉的是，如果submodule有更新，默认在本地父项目里执行git pull是不会更新submodule的。因为执行git submodule add xxx的时候，只是把submodule的当前commit id加入到本地父项目的索引里，如果你期望submodule的commit id同步到最新HEAD，则你还需要重新执行git add然后重新提交。

此后，其他开发成员需要执行git submodule update更新你刚才的这个submodule commit。这里一个需要注意的地方是，每次在父项目执行git pull后，应该执行git status查看一下submodule是否有更新；如果submodule有更新，则应该立刻执行git submodule update，否则你有可能把submodule的旧依赖提交到仓库里去。一个建议是，尽量不要执行git commit -a，它会让你忽略对staged文件的确认过程。

实际案例演示

常见情况

给出一个在父项目 proj.git 里添加submodule项目 lib.git 并使用的示例：

(用户A) 创建新的代码仓库：

mkdir proj

cd proj

git init

git add --all

(用户A) 添加pdlib作为submodule：

git submodule add git@github.com:lib.git

git commit -m "first commit with submodule"

git remote add origin git@github.com:proj.git

git push origin master

(用户B) 签出刚刚新建的代码仓库并使用：

git clone git@github.com:proj.git

cd foo

git submodule update --init --recursive

(用户B) 发现lib.git有修改，他把proj.git仓库的lib.git也同步到该版本：

cd lib

git pull

git status        # 此时如果lib.git有修改，就可以看到not staged commit

cd ..

git add lib

git commit -m "update lib.git"

git push origin master

(用户C) 更新proj.git仓库，同时也需要更新submodule：

git pull origin master

git status        # 记得执行git status，可以看到lib.git的改动

git submodule update

修改lib.git

【注】这种情况下，需要清楚lib.git和proj.git实际就是两个独立的git仓库，针对lib.git的修改，需要在lib目录下commit。注意submodule*必须*是在master分支修改，如果proj.git在其他分支上开发，那么针对lib目录的修改需要先切回master分支。

(用户D) 想直接在proj.git仓库里修改lib目录的内容：

cd lib

git checkout master  # 注意修改lib需要在master分支上

edit xxx.txt

git add xxx.txt

git commit -m "update xxx.txt"

git push origin master

(用户D) 需要显式的把刚在lib目录上的修改添加到proj.git仓库里去：

cd proj

git status        # 每次在commit之前查看一下status是好习惯

git add lib

git commit -m "update lib.git"

git push origin master

技巧

可以通过修改 ~/.gitconfig 简化一些操作，比如每次git pull完自动执行git submodule update：

[alias]

psu = !git pull && git submodule update

这样，上面示例中用户C如下操作即可：

git psu

参考