Git Submodule管理專案子模組

2022-08-20 04:15:11 字數 3849 閱讀 5388

當專案越來越龐大之後,不可避免的要拆分成多個子模組,我們希望各個子模組有獨立的版本管理,並且由專門的人去維護,這時候我們就要用到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,所以.gitmodulesmodulea這兩項是需要提交到父專案的遠端倉庫的。

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"

但是我自己本地實驗的時候,發現用下面的方式也可以,伺服器記錄的是.gitmodulesmodulea,本地只要用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...