git Submodule的使用

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

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

1
2
3
git clone --recurse-submodules <main_project_url>
# 获取主项目和所有子项目源码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
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

1
2
3
4
5
[submodule <submodule_name>]
path = <local_directory>
url = <remote_url>
branch = <remote_update_branch_name>

1
2
3
4
5
# stash所有submodules
git submodule foreach 'git stash'
# 所有submodules创建新分支
git submodule foreach 'git checkout -b <branch_name>'

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

1
2
3
git supdate
git spush