git submodule子模块

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

1、添加子模块

git submodule add 【URL】【path】

其中，url为子模块的路径，path为该子模块存储的目录路径

安装完成后会创建或者修改.gitmodules，新增一个文件路径

<img src="https://img.58cdn.com.cn/escstatic/fecar/pmuse/reactnative/git2.png" />

.gitmodules内容如下：

<img src="https://img.58cdn.com.cn/escstatic/fecar/pmuse/reactnative/git3.png" />

2、初始化更新子模块

初始化本地配置文件

git submodule init

更新子模块

git submodule foreach "git pull origin master"

多个子模块都可以更新

3、修改子模块

cd rn-app(子模块目录)

modified子模块

git commit -am "modified commit" 提交修改内容

git push origin master 提交代码到远程仓库

4、克隆子模块

有两种方式克隆子模块：

(1)、采用递归参数 --recursive 克隆整个项目

git clone --recursive git@igit.58corp.com:cst-rn/rnSubscribe.git

<img src="https://img.58cdn.com.cn/escstatic/fecar/pmuse/reactnative/git6.png" />

可以看到只有父项目添加的子模块，在clone时，都会递归的把子模块全部克隆到项目里面

(2)、先clone父项目，在初始化submodule

git clone git@igit.58corp.com:cst-rn/rnSubscribe.git

cd rnSubscribe

git submodule init

git submodule update

<img src="https://img.58cdn.com.cn/escstatic/fecar/pmuse/reactnative/git7.png" />

5、子模块删除

git rm --cached 子模块目录 删除子模块缓存

rm -rf 子模块目录 删除子模块目录

vim .gitmodules 删除对于子模块相关条目

vim .git/config 删除配置项中子模块相关条目

常见问题

1、一些操作导致子模块无法正常添加

<img src="https://img.58cdn.com.cn/escstatic/fecar/pmuse/reactnative/git4.png" />

使用一下命令安装：

git submodule add --name Common git@gitlab.abc.com:cs70/console-before.git ./rn-app

或者

git submodule add --force git@igit.58corp.com:cst-rn/rn-app.git

2、提示子模块已存在 但是本地并未见到

<img src="https://img.58cdn.com.cn/escstatic/fecar/pmuse/reactnative/git5.png" />

删除子模块是未删除干净

git rm --cached rn-design
rm -rf rn-design
rm .gitmodules

vim .git/config 删除配置项中子模块相关条目