面對比較復雜的項目，我們有可能會將代碼根據(jù)功能拆解成不同的子模塊。主項目對子模塊有依賴關系，卻又并不關心子模塊的內部開發(fā)流程細節(jié)。
這種情況下，通常不會把所有源碼都放在同一個 Git 倉庫中。
有一種比較簡單的方式，是在當前工作目錄下，將子模塊文件夾加入到 .gitignore 文件內容中，這樣主項目就能夠無視子項目的存在。這樣做有一個弊端就是，使用主項目的人需要有一個先驗知識：需要在當前目錄下放置一份某版本的子模塊代碼。
還有另外一種方式可供借鑒，可以使用 Git 的 submodule 功能，這也是接下來準總結的內容。
實際上 Git 工具的 submodule 功能就是建立了當前項目與子模塊之間的依賴關系：子模塊路徑、子模塊的遠程倉庫、子模塊的版本號。

使用流程

假定我們有兩個項目：project-main 和 project-sub-1，其中 project-main 表示主項目，而 project-sub-1 表示子模塊項目。
其中 project-main 的遠程倉庫地址為 https://github.com/username/project-main.git，而 project-sub-1 的遠程倉庫地址為 https://github.com/username/project-sub-1.git。
接下來，我們希望在 project-main 中添加 project-sub-1 ，而又保持 project-sub-1 自身獨立的版本控制。

1.創(chuàng)建 submodule

使用 git submodule add <submodule_url> 命令可以在項目中創(chuàng)建一個子模塊。
如：

git submodule add https://github.com/xjh22222228/project-sub-1.git

此時項目倉庫中會多出兩個文件：.gitmodules 和 project-sub-1 。
前者的內容是這樣的，事實上就是子模塊的相關信息；而后者那個文件，實際上保存的是子模塊當前版本的版本號信息。

[submodule "project-sub-1"]
path = project-sub-1
url = xxxxxxxx

事實上，此時在 .git/config 文件中也會多出一些信息，在 .git/modules 文件夾下也會多出一份內容。
新建的子模塊，對應的都是master分支，可以使用下面的指令，比如切換到test分支

git config -f .gitmodules submodule.common.branch test

添加完子模塊之后記得一定要進行一次推送，這樣子模塊的更新才能更新的遠程倉庫中，使用 git commit -m "add submodule xxx" 提交一次，表示引入了某個子模塊。提交后，在主項目倉庫中，會顯示出子模塊文件夾，并帶上其所在倉庫的版本號。

image.png

2.獲取 submodule

上述步驟在創(chuàng)建子模塊的過程中，會自動將相關代碼克隆到對應路徑，但對于后續(xù)使用者而言，對于主項目使用普通的 clone 操作并不會拉取到子模塊中的實際代碼。
如果希望子模塊代碼也獲取到，一種方式是在克隆主項目的時候帶上參數(shù) --recurse-submodules，這樣會遞歸地將項目中所有子模塊的代碼拉取。
git clone xxxxxxx --recurse-submodules
此時 project-main/project-sub-1 文件夾是有內容的，并且固定在某個 Git 提交的版本上。
另外一種可行的方式是，在當前主項目中執(zhí)行：

git submodule init
git submodule update

則會根據(jù)主項目的配置信息，拉取更新子模塊中的代碼。
拉取指定子模塊的更新內容，如子模塊project-sub-1

git submodule update --remote project-sub-1

切換分支或者克隆父項目后，所有的子模塊分支都指向 detached head， 為了修復這個問題，直接在根項目執(zhí)行：

git submodule foreach -q --recursive 'git checkout $(git config -f $toplevel/.gitmodules submodule.$name.branch || echo master)'

執(zhí)行去除detached head操作指令后需要切換到我們需要的分支中，先修改gitmodules的文件分支記錄

git config -f .gitmodules submodule.common.branch test

3.子模塊內容的更新

對于子模塊而言，并不需要知道引用自己的主項目的存在。對于自身來講，子模塊就是一個完整的 Git 倉庫，按照正常的 Git 代碼管理規(guī)范操作即可。
對于主項目而言，子模塊的內容發(fā)生變動時，通常有三種情況：
（1）當前項目下子模塊文件夾內的內容發(fā)生了未跟蹤的內容變動；
（2）當前項目下子模塊文件夾內的內容發(fā)生了版本變化；
（3）當前項目下子模塊文件夾內的內容沒變，遠程有更新；

情況1：子模塊有未跟蹤的內容變動

對于第1種情況，通常是在開發(fā)環(huán)境中，直接修改子模塊文件夾中的代碼導致的。
此時在主項目中使用 git status 能夠看到關于子模塊尚未暫存以備提交的變更，但是于主項目而言是無能為力的，使用 git add/commit 對其也不會產(chǎn)生影響。
在此情景下，通常需要進入子模塊文件夾，按照子模塊內部的版本控制體系提交代碼。
當提交完成后，主項目的狀態(tài)則進入了情況2，即當前項目下子模塊文件夾內的內容發(fā)生了版本變化。

情況2：子模塊有版本變化
當子模塊版本變化時，在主項目中使用 git status 查看倉庫狀態(tài)時，會顯示子模塊有新的提交
在這種情況下，可以使用 git add/commit 將其添加到主項目的代碼提交中，實際的改動就是那個子模塊 文件 所表示的版本信息，代碼示例：

-Subproject commit ace977071f94f4f88935f9bb9a33ac0f8b4ba935
+Subproject commit 7097c4887798b71cee360e99815f7dbd1aa17eb4

通常當子項目更新后，主項目修改其所依賴的版本時，會產(chǎn)生類似這種情景的 commit 提交信息。

情況3：子模塊遠程有更新

通常來講，主項目與子模塊的開發(fā)不會恰好是同時進行的。通常是子模塊負責維護自己的版本升級后，推送到遠程倉庫，并告知主項目可以更新對子模塊的版本依賴。
在這種情況下，主項目是比較茫然的。
之前曾經(jīng)提到，主項目可以使用 git submodule update 更新子模塊的代碼，但那是指 當前主項目文件夾下的子模塊目錄內容 與 當前主項目記錄的子模塊版本 不一致時，會參考后者進行更新。
但如今這種情況下，后者 當前主項目記錄的子模塊版本 還沒有變化，在主項目看來當前情況一切正常。
此時，需要讓主項目主動進入子模塊拉取新版代碼，進行升級操作。
通常流程是：

cd project-sub-1
git pull origin master

子模塊目錄下的代碼版本會發(fā)生變化，轉到情況2的流程進行主項目的提交。
當主項目的子項目特別多時，可能會不太方便，此時可以使用 git submodule 的一個命令 foreach 執(zhí)行：

git submodule foreach 'git pull origin master'

情況匯總

終上所述，可知在不同場景下子模塊的更新方式如下：

• 對于子模塊，只需要管理好自己的版本，并推送到遠程分支即可；
• 對于父模塊，若子模塊版本信息未提交，需要更新子模塊目錄下的代碼，并執(zhí)行 commit 操作提交子模塊版本信息；
• 對于父模塊，若子模塊版本信息已提交，需要使用 git submodule update ，Git 會自動根據(jù)子模塊版本信息更新所有子模塊目錄的相關代碼。

4.刪除子模塊

根據(jù)官方文檔的說明，應該使用 git submodule deinit 命令卸載一個子模塊。這個命令如果添加上參數(shù) --force，則子模塊工作區(qū)內即使有本地的修改，也會被移除。

git submodule deinit project-sub-1
git rm project-sub-1

執(zhí)行 git submodule deinit project-sub-1 命令的實際效果，是自動在 .git/config 中刪除了以下內容：

[submodule "project-sub-1"]
url = xxxxxx

執(zhí)行 git rm project-sub-1 的效果，是移除了 project-sub-1 文件夾，并自動在 .gitmodules 中刪除了以下內容：

[submodule "project-sub-1"]
path = project-sub-1
url = xxxxxx

此時，主項目中關于子模塊的信息基本已經(jīng)刪除（雖然貌似 .git/modules 目錄下還有殘余）
接下來可以提交代碼：

git commit -m "delete submodule project-sub-1"

如果項目移除掉原來的子模塊 可以去.git文件中刪除相關的配置文件，.git文件夾中的modules記錄的就是子模塊的信息

總結

當項目比較復雜，部分代碼希望獨立為子模塊進行版本控制時，可以使用 git submodule 功能。
使用 git submodule 功能時，主項目倉庫并不會包含子模塊的文件，只會保留一份子模塊的配置信息及版本信息，作為主項目版本管理的一部分。