git submodule来管理独立git子目录

在软件开发过程中，通常我们会遇到有一些通用的部分希望抽取出来做成一个公共库的情况，比如安卓和IOS都通用的H5页面。而公共代码库的版本管理是个麻烦的事情。幸运的是，万能的Git有个叫子模组(git submodule)的命令完美地帮我们解决了这个问题。

添加子模块

为当前工程添加submodule，命令如下：

git submodule add 仓库地址 路径

其中，仓库地址是指子模块仓库地址，路径指将子模块放置在当前工程下的路径。

注意：路径不能以 / 结尾（会造成修改不生效）、不能是现有工程已有的目录（不能順利 Clone）

命令执行完成，会在当前工程根路径下生成一个名为“.gitmodules”的文件，其中记录了子模块的信息。添加完成以后，再将子模块所在的文件夹添加到工程中即可。

下载的工程带有submodule

当使用git clone下来的工程中带有submodule时，初始的时候，submodule的内容并不会自动下载下来的，此时，只需执行如下命令：

git submodule init

git submodule update

或者是执行以下命令（该命令效果等同于上面两个命令）：

git submodule update --init --recursive

即可将子模块内容下载下来后工程才不会缺少相应的文件。

更新submodule的URL

1.更新.gitsubmodule中对应submodule的条目URL

2.更新 .git/config 中对应submodule的条目的URL

3.执行 git submodule sync

删除子模块

1. 使用vim编辑.gitmodules(vim  .gitmodule), 删除对应要删除的submodule的行．

2. 使用vim编辑.git/config,删除有对应要删除的submodule的行．

3.执行 git rm --cached {submodule_path}。注意，路径不要加后面的“/”。例如：你的submodule保存在 supports/libs/websocket/ 目录。执行命令为： git rm --cached supports/libs/websocket

手册

usage: git submodule [--quiet] [--cached]
   or: git submodule [--quiet] add [-b <branch>] [-f|--force] [--name <name>] [--reference <repository>] [--] <repository> [<path>]
   or: git submodule [--quiet] status [--cached] [--recursive] [--] [<path>...]
   or: git submodule [--quiet] init [--] [<path>...]
   or: git submodule [--quiet] deinit [-f|--force] (--all| [--] <path>...)
   or: git submodule [--quiet] update [--init] [--remote] [-N|--no-fetch] [-f|--force] [--checkout|--merge|--rebase] [--[no-]recommend-shallow] [--reference <repository>] [--recursive] [--] [<path>...]
   or: git submodule [--quiet] set-branch (--default|--branch <branch>) [--] <path>
   or: git submodule [--quiet] summary [--cached|--files] [--summary-limit <n>] [commit] [--] [<path>...]
   or: git submodule [--quiet] foreach [--recursive] <command>
   or: git submodule [--quiet] sync [--recursive] [--] [<path>...]
   or: git submodule [--quiet] absorbgitdirs [--] [<path>...]