Git 命令行管理项目子模块之submodule

2018-02-07 09:07:00
莫水千流
转贴:
博客园
1696

常用命令

git clone <repository> --recursive 递归的方式克隆整个项目
git submodule add <repository> <path> 添加
git submodule init 初始化
git submodule update 更新
git submodule foreach git pull 拉取所有

创建带子模块的版本库

1.正常初始化你的项目仓库

git init
git add .
git commit -m "demo"
git push origin master

创建子模块版本库(childModule.git),并提交文件

在你的项目中引入子模块,并提交子模块信息

cd 主项目目录
git submodule add ../childModule.git childModule
git status
git diff
git add .
git commit -m "add submodule"
git push origin master
cd ..

使用git status可以看到多了需要提交的文件,其中.gitmodules指定submodule的主要信息,包括子模块的路径和地址信息,childModule指定了子模块的commit id,
使用git diff可以看到这两项的内容。这里需要指出父项目的git并不会记录submodule的文件变动,它是按照commit id指定submodule的git header,所以.gitmodules和childModule这两项是需要提交到父项目的远程仓库的。

克隆带子模块的版本库

方案一,先clone父项目,再初始化submodule,最后更新submodule,初始化只需要做一次,之后每次只需要直接update就可以了,需要注意submodule默认是不在任何分支上的,它指向父项目存储的submodule commit id。

git submodule init
git submodule update

方案二,采用递归参数--recursive,需要注意同样submodule默认是不在任何分支上的,它指向父项目存储的submodule commit id。

git clone --recursive ........

修改子模块

修改子模块之后只对子模块的版本库产生影响,对父项目的版本库不会产生任何影响,如果父项目需要用到最新的子模块代码,我们需要更新父项目中submodule commit id,默认的我们使用git status就可以看到父项目中submodule commit id已经改变了,我们只需要再次提交就可以了。

更新子模块

更新子模块的时候要注意子模块的分支默认不是master。

方案一,先pull父项目,再执行git submodule update,注意childModule的分支始终不是master。

方案二,先进入子模块,然后切换到需要的分支,这里是master分支,然后对子模块pull,这种方法会改变子模块的分支。

git checkout master
git submodule foreach git pull

删除子模块

git rm childModule
git status
git commit -m "remove submodule"
git push origin master
发表评论
评论通过审核后显示。