Git Submodule 嵌套子模块_git submodule update --remote

Git Submodule 嵌套子模块

摘要:本文介绍了包含有git Submodule的常用操作,包含创建Submodule,拉取,提交等常用开发操作.

1. 在仓库中增加Submodule

在.git的同级目录下执行:

git submodule add <url>
1

注意:要确保协同开发主仓库的所有人员,都可以访问＜url＞;

在仓库中增加完毕submodule后,要执行提交(commit)和推送(push)操作;

2. 查看子模块状态

先设置显示子模块的简明信息:

git config status.submodulesummary 1
1

查看状态，包含子模块的信息：

git status
1

查看子项目的日志记录:

git log -p --submodule
1

查看空间中某一submodule状态:

git diff --cached <submodule_package_file_name>
1

查看空间中全部submodule状态:

git diff --cached --submodule
1

3. 克隆含有Submodule的项目

• 方法一:

克隆项目,默认带有空的Submodule文件夹:

git clone <url> [<rename>]
1

初始化Submodule:

git submodule init
1

更新Submodule中的内容至当前版本:

git submodule update
1

• 方法二：
  克隆项目的同时,检出所有嵌套的子模块;

git clone --recurse-submodules <url> [<rename>]
1

4. 在包含子模块的项目上工作

4.1 从子模块的远端拉取上游修改

• 方法一:
  远程抓取+合并:

git fetch <url> [<branch-name>:<branch-name>]
git merge <branch_name>
1
2

• 方法二:
  将远程git内容同步至本地的一个游离分支上;

git submodule update --remote [<submodule-name>]
1

需要建立分支temp继承游离分支HEAD:

git branch temp HEAD
1

在master分支中合并temp分支:

git checkout master
git merge temp
1
2

• 方法三:
  将远程内容合并到本地submodule所处的分支上:

git submodule update --remote --merge
1

• 方法四:
  将本地分支变基到远程submodule的最新状态:

git submodule update --remote --rebase
1

4.2 从项目远端拉取上游更改

git pull <remote-name> --recurse-submodules
1

如果 .gitmodules 文件中记录的子模块的 URL 发生了改变:

# 将新的 URL 复制到本地配置中
git submodule sync --recursive
# 从新 URL 更新子模块
git submodule update --init --recursive
1
2
3
4