GIT Submodule的使用

当一个项目须要包含其余支持项目源码时使用的功能，做用是两个项目是独立的，且主项目可使用另外一个支持项目。

git submodule add <submodule_url>  # 添加子项目

添加子项目后会出现.gitmodules的文件，这是一个配置文件，记录mapping between the project's URL and the local subdirectory。且.gitmodules在git版本控制中，这样其余参与项目的人才能知道submodule projects的状况。

git submodule init  # 初始化本地.gitmodules文件
git submodule update  # 同步远端submodule源码

若是获取的项目包含submodules，pull main project的时候不会同时获取submodules的源码，须要执行本地.gitmodules初始化的命令，再同步远端submodule源码。若是但愿clone main project的时候包含全部submodules，可使用下面的命令

git clone --recurse-submodules <main_project_url>  # 获取主项目和全部子项目源码

操做submodules源码：先进入submodule的direcotry，再执行下述命令

git fetch  # 获取submodule远端源码
git merge origin/<branch_name>  # 合并submodule远端源码
git pull  # 获取submodule远端源码合并到当前分支
git checkout <branch_name>  # 切换submodule的branch
git commit -am "change_summary"  # 提交submodule的commit
 # or  # 更新submodule源码，默认更新的branch是master，若是要修改branch，在.gitmodule中设置 git submodule update --remote <submodule_name> # 更新全部submodule源码，默认更新.gitmodule中设置的跟踪分支，未设置则跟踪master git submodule update --remote # 当submodule commits提交有问题的时候放弃整个push git push --recurse-submodules=check # 分开提交submodule和main project git push --recurse-submodules=on-demand 

.gitmodule内容大体以下

[submodule <submodule_name>] path = <local_directory> url = <remote_url> branch = <remote_update_branch_name> 

用'foreach'关键字同时管理多个submodules，以下

# stash全部submodules git submodule foreach 'git stash' # 全部submodules建立新分支 git submodule foreach 'git checkout -b <branch_name>' 

submodules的命令很长，为提高效率，能够建立alias，记录在.git/config路径下。以下：

git config alias.spush 'push --recurse-submodules=on-demand'
git config alias.supdate 'submodule update --remote --merge'

这样，可使用下面的命令来提升效率

git supdate
git spush

做者：Sisyphus235 连接：https://www.jianshu.com/p/0107698498af 来源：简书 简书著做权归做者全部，任何形式的转载都请联系做者得到受权并注明出处。