Git Submodule管理專案子模組

當專案越來越龐大之後，不可避免的要拆分成多個子模組，我們希望各個子模組有獨立的版本管理，並且由專門的人去維護，這時候我們就要用到git的submodule功能。

git clone --recursive 遞迴的方式轉殖整個專案

git submodule add 新增子模組
git submodule init 初始化子模組
git submodule update 更新子模組
git submodule foreach git pull 拉取所有子模組

例如我們要建立如下結構的專案

project

|--modulea
|--readme.txt

建立project版本庫，並提交readme.txt檔案

git init --bare project.git

git clone project.git project1
cd project1
echo "this is a project." > readme.txt
git add .
git commit -m "add readme.txt"
git push origin master
cd ..

建立modulea版本庫，並提交a.txt檔案

git init --bare modulea.git

git clone modulea.git modulea1
cd modulea1
echo "this is a submodule." > a.txt
git add .
git commit -m "add a.txt"
git push origin master
cd ..

在project專案中引入子模組modulea，並提交子模組資訊

cd project1

git submodule add ../modulea.git modulea
git status
git diff
git add .
git commit -m "add submodule"
git push origin master
cd ..

使用git status可以看到多了兩個需要提交的檔案，其中.gitmodules指定submodule的主要資訊，包括子模組的路徑和位址資訊，modulea指定了子模組的commit id，使用git diff可以看到這兩項的內容。這裡需要指出父專案的git並不會記錄submodule的檔案變動，它是按照commit id指定submodule的git header，所以.gitmodules和modulea這兩項是需要提交到父專案的遠端倉庫的。

on branch master

your branch is up-to-date with 'origin/master'.
changes to be committed:
(use "git reset head ..." to unstage)
new file:   .gitmodules
new file:   modulea

方法一，先clone父專案，再初始化submodule，最後更新submodule，初始化只需要做一次，之後每次只需要直接update就可以了，需要注意submodule預設是不在任何分支上的，它指向父專案儲存的submodule commit id。

git clone project.git project2

cd project2
git submodule init
git submodule update
cd ..

方法二，採用遞迴引數--recursive，需要注意同樣submodule預設是不在任何分支上的，它指向父專案儲存的submodule commit id。

git clone project.git project3 --recursive

cd project1/modulea

git branch
echo "this is a submodule." > b.txt
git add .
git commit -m "add b.txt"
git push origin master
cd ..
git status
git diff
git add .
git commit -m "update submodule add b.txt"
git push origin master
cd ..

更新子模組的時候要注意子模組的分支預設不是master。

方法一，先pull父專案，然後執行git submodule update，注意modulea的分支始終不是master。

cd project2

git pull
git submodule update
cd ..

方法二，先進入子模組，然後切換到需要的分支，這裡是master分支，然後對子模組pull，這種方法會改變子模組的分支。

cd project3/modulea

git checkout master
cd ..
git submodule foreach git pull
cd ..

網上有好多用的是下面這種方法

git rm --cached modulea

rm -rf modulea
rm .gitmodules
vim .git/config

刪除submodule相關的內容，例如下面的內容

[submodule "modulea"]

url = /users/nick/dev/nick-doc/testgitsubmodule/modulea.git

然後提交到遠端伺服器

git add .

git commit -m "remove submodule"

但是我自己本地實驗的時候，發現用下面的方式也可以，伺服器記錄的是.gitmodules和modulea，本地只要用git的刪除命令刪除modulea，再用git status檢視狀態就會發現.gitmodules和modulea這兩項都已經改變了，至於.git/config，仍會記錄submodule資訊，但是本地使用也沒發現有什麼影響，如果重新從伺服器轉殖則.git/config中不會有submodule資訊。

git rm modulea

git status
git commit -m "remove submodule"
git push origin master

案例：討論 ** 專案 mall 中的 admin 是編譯專案包 ，每次編譯都會產生很多修改，不利於我們對比** ，現將mall 中的 admin 移出 mall 專案**庫 ，admin 新起乙個**庫 ，並將 admin **庫作為 mall專案的 乙個 submodule ， mall**庫的 dev 分支已經 移出了 admin， 各位各自的分支 需合併 dev 分支到各自的開發分支上 ，合併後 admin 目錄將消失 ，

在專案目錄下執行命令 git submodule add admin 即可新增admin成功，

後續 admin有更新 執行命令 git pull 後， 執行 命令 git submodule foreach git pull 即可拉取新的 admin新包

Git Submodule 管理專案子模組

1 新增乙個子模組 git submodule add 子模組位址 自定義到當前工程的路徑 git commit git push 2 轉殖 更新帶子模組的工程 2.1 方法一 git clone 工程位址，進入工程後 git submodule init init 操作只需要在剛clone下來時執...

Git Submodule管理專案子模組

使用場景 當專案越來越龐大之後，不可避免的要拆分成多個子模組，我們希望各個子模組有獨立的版本管理，並且由專門的人去維護，這時候我們就要用到git的submodule功能。常用命令git clone recursive 遞迴的方式轉殖整個專案 git submodule add 新增子模組 git s...

git submodule來管理獨立git子目錄

在軟體開發過程中，通常我們會遇到有一些通用的部分希望抽取出來做成乙個公共庫的情況，比如安卓和ios都通用的h5頁面。而公共 庫的版本管理是個麻煩的事情。幸運的是，萬能的git有個叫子模組 git submodule 的命令完美地幫我們解決了這個問題。為當前工程新增submodule，命令如下 git...