git submodule 的使用

当我们要把另一个仓库的代码作为子目录放到当前仓库时,为了防止代码冗余,我们应该使用 git 的子模块 submodule 功能。

引入

https://github.com/my/repo.git 引入当前项目,创建一个folder 文件夹来存放代码。

git submodule add https://github.com/my/repo.git folder

此时仓库里会有个 .gitmodules 文件,记录了子仓库信息。我们可以添加多个子仓库。

提交

对主仓库、子仓库都更新代码后,我们提交时,需要依次对两个仓库的 repo 进行提交。在主仓库里进行 git diff 会看到

--- a/folder
+++ b/folder
-Subproject commit 8ffcce923b69d314938ce5485f2ac022986aebcb
+Subproject commit 8ffcce923b69d314938ce5485f2ac022986aebcb-dirty

也就是说主仓库会记录当前该文件夹所用的子项目的 commit 号,所以应该先提交子仓库,再提交主仓库。

拉取

加上--recurse-submodules 参数可以在克隆时初始化并更新子模块。

git clone xx.git --recurse-submodules
  • 如果用的是 zsh,自带的 alias gcl='git clone --recurse-submodules',也就是用 gcl xx.git 就可以了。

  • 一些文章提到的 --recursive 参数也是一样的作用。

初始化和更新

如果项目拉取时没有加上上面参数,那么需要手动初始化和更新。

初始化并递归更新所有子模块:

git submodule update --init --recursive

也可以分开操作,初始化只需要执行一次:

git submodule init

每次需要更新子仓库时,运行:

git submodule update

删除

还没提交 git 记录的话,把下载的文件夹和 .gitmodules 中相关内容删除即可。否则:

  • git rm --cached folder 删除目录
  • .gitmodules 删除相关内容
  • .git/config 删除.git 中相关内容
  • rm -rf .git/modules/folder 删除相关内容

┆凉┆暖┆降┆等┆幸┆我┆我┆里┆将┆ ┆可┆有┆谦┆戮┆那┆ ┆大┆始┆ ┆然┆
┆薄┆一┆临┆你┆的┆还┆没┆ ┆来┆ ┆是┆来┆逊┆没┆些┆ ┆雁┆终┆ ┆而┆
┆ ┆暖┆ ┆如┆地┆站┆有┆ ┆也┆ ┆我┆ ┆的┆有┆精┆ ┆也┆没┆ ┆你┆
┆ ┆这┆ ┆试┆方┆在┆逃┆ ┆会┆ ┆在┆ ┆清┆来┆准┆ ┆没┆有┆ ┆没┆
┆ ┆生┆ ┆探┆ ┆最┆避┆ ┆在┆ ┆这┆ ┆晨┆ ┆的┆ ┆有┆来┆ ┆有┆
┆ ┆之┆ ┆般┆ ┆不┆ ┆ ┆这┆ ┆里┆ ┆没┆ ┆杀┆ ┆来┆ ┆ ┆来┆
原文地址:https://www.cnblogs.com/flipped/p/15477222.html