git submodule 使用说明

发表于 更新于 阅读次数： 本文字数： 1k 阅读时长 ≈ 2 分钟

Git Submodule允许你将一个Git仓库作为另一个Git仓库的子目录。 它能让你将另一个仓库克隆到自己的项目中，同时还保持提交的独立。
最近在实际项目开发中，用到了，也遇到一些细节问题，所以将Git子模块常用操作总结如下，以备不时之需。

添加子模块

1
2
3
4
5
6
# 添加子模块
$ git submodule add https://github.com/alanhg/Angular-group.git

# 设定映射路径lib
$ git submodule add https://github.com/alanhg/Angular-group.git lib

关于具体使用设定下，执行help命令

1
2
$ git submodule --help

克隆含有子模块的项目

取项目代码

  • 方法1
    1. 克隆项目，子模块目录默认被克隆，但是是空的
      $ git clone https://github.com/chaconinc/MainProject
    2. 初始化子模块：初始化本地配置文件
      $ git submodule init
    3. 该项目中抓取所有数据并检出父项目中列出的合适的提交
      $ git submodule update
  • 方法2
    $ git clone --recursive https://github.com/chaconinc/MainProject

更新子模块代码

  • 方法1

    1
    2
    3
    $ cd DbConnector
    $ git fetch
    $ git merge origin/master

  • 方法2

    1
    2
    3
    4
    5
    $ git submodule update --remote DbConnector
    # 这里默认更新master分支，如果更新其他分支
    $ git config -f .gitmodules submodule.DbConnector.branch stable
    $ git submodule update --remote
    $ git merge origin/master

提交子模块更新

1
2
3
4
$ cd DbConnector
$ git checkout stable
$ git submodule update --remote --merge
$ git push

删除子模块

比如直接删除.gitmodules文件是不行的，因为.git中还是会有相关映射记录，so需要执行以下命令才可安全删除。

1
2
3
4
$ rm -rf .git/modules
 
# 删除.gitmodules中记录的模块信息（--cached选项清除.git/modules中的缓存）
$ git rm --cached {MOD_NAME}

参考文档