當專案越來越龐大之後,不可避免的要拆分成多個子模組,我們希望各個子模組有獨立的版本管理,並且由專門的人去維護,這時候我們就要用到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
修改子模組之後只對子模組的版本庫產生影響,對父專案的版本庫不會產生任何影響,如果父專案需要用到最新的子模組**,我們需要更新父專案中submodule commit id,預設的我們使用git status
就可以看到父專案中submodule commit id已經改變了,我們只需要再次提交就可以了。
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
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 submodule ...
Git Submodule管理專案子模組
使用場景 當專案越來越龐大之後,不可避免的要拆分成多個子模組,我們希望各個子模組有獨立的版本管理,並且由專門的人去維護,這時候我們就要用到git的submodule功能。常用命令git clone recursive 遞迴的方式轉殖整個專案 git submodule add 新增子模組 git s...