子模塊的添加
添加子模塊非常簡單，命令如下：

git submodule add <url> <path>

其中，url為子模塊的路徑，path為該子模塊存儲的目錄路徑。

執(zhí)行成功后，git status會看到項目中修改了.gitmodules，并增加了一個新文件（為剛剛添加的路徑）

git diff --cached查看修改內(nèi)容可以看到增加了子模塊，并且新文件下為子模塊的提交hash摘要

git commit提交即完成子模塊的添加
 

submodule 常用命令

• git submodule: 顯示所有 submodule, 等同于git submodule status
• 添加 submodule 到現(xiàn)有項目
  1. Run git submodule add -b <branch> --name <name> <repo-url> <local dir>
  2. Commit both files on the superproject
• 從當前項目移除 submodule
  1. git submodule deinit -f <submodule_path>
  2. rm -rf .git/modules/<submodule_path>
  3. git rm -f <submodule_path>

• 復制含 submodule 項目到本地

  1. Clone the superproject as usual
  2. Run git submodule init to init the submodules
  3. Run git submodule update to have the submodules on a detached HEAD

  或者直接執(zhí)行 git clone --recurse-submodules <repo-url>

• git submodule init: 將本項目所依賴的 submodule 進行初始化
• git submodule update: 更新 submodule 為 superproject 本次 commit 所記錄的版本 (本地版本為舊版本的話那么就與舊版本保持同步!)
• git submodule update --init: 前面兩個命令的合并
• git submodule update --init --recursive: 前面三個命令的合集, --recursive 是為了保證即使 submodule 又嵌套了 sub-submodule, 也可以被執(zhí)行到. 這個命令比較全面, 會經(jīng)常使用
• git submodule update --remote: 更新 submodule 為遠程項目的最新版本 (更為常用!)
• git submodule update --remote <submodule-name>: 更新指定的 submodule 為遠程的最新版本
• git push --recurse-submodules=
  • check: 檢查 submodule 是否有提交未推送, 如果有, 則使本次提交失敗
  • on-demand: 先推送 submodule 的更新, 然后推送主項目的更新 (如果 submodule 推送失敗, 那么推送任務直接終止)
  • while: 所有的 submodule 會被依次推送到遠端, 但是 superproject 將不會被推送
  • no: 與 while 相反, 只推送 superproject, 不推送其他 submodule
• git pull --recurse-submodules: 拉取所有子倉庫 (fetch) 并 merge 到所跟蹤的分支上
• git diff --submodule: 查看 submodule 所有改變
• git submodule foreach '<arbitrary-command-to-run>': 對所有 submodule 執(zhí)行命令, 非常有用, 如 git submodule foreach 'git checkout main'
• git diff --submodule: 查看 submodule 所有改變