在Git中添加子模塊(submodule)的詳細步驟
更新時間：2026年01月09日 09:36:13 作者：Tipriest_
Git子模塊(submodule)允許在一個項目中包含另一個獨立的git倉庫,使用時需注意,子模塊提交push后,主模塊需同步更新其記錄的子模塊hash值,否則可能導(dǎo)致沖突,本文詳細介紹了如何添加子模塊,需要的朋友可以參考下
在 Git 中添加子模塊（submodule）的詳細步驟如下：
1. 添加子模塊
命令格式：
git submodule add <倉庫URL> [目標(biāo)路徑]
- 倉庫URL：子模塊的 Git 倉庫地址（HTTP/SSH 均可）。
- 目標(biāo)路徑（可選）：子模塊在主倉庫中的存放路徑。若省略，默認使用倉庫名稱作為路徑。
示例：
git submodule add https://github.com/example/thirdparty.git libs/thirdparty
- 將
thirdparty倉庫添加到主倉庫的libs/thirdparty目錄下。
執(zhí)行后效果：
- 克隆子模塊倉庫到指定路徑。
- 在主倉庫根目錄生成
.gitmodules文件，記錄子模塊信息（URL 和路徑）。 - 在
.git/modules/目錄下保存子模塊的 Git 元數(shù)據(jù)。
2. 提交主倉庫的變更
子模塊添加后，主倉庫會生成兩個變更：
.gitmodules文件（新增）。- 子模塊路徑對應(yīng)的提交 ID（類似
160000模式的文件）。
提交命令：
git commit -m "添加子模塊: thirdparty"
3. 克隆含子模塊的主倉庫
其他協(xié)作者克隆主倉庫后，需初始化子模塊：
方式一：遞歸克?。ㄍ扑]）
git clone --recurse-submodules <主倉庫URL>
- 一次性克隆主倉庫并初始化所有子模塊。
方式二：分步初始化
克隆主倉庫：
git clone <主倉庫URL>
初始化子模塊：
git submodule init
拉取子模塊代碼：
git submodule update
4. 更新子模塊
拉取子模塊的最新代碼
進入子模塊目錄：
cd libs/thirdparty
拉取更新并切換至最新提交：
git checkout main # 切換到目標(biāo)分支 git pull
返回主倉庫目錄，提交子模塊的變更：
cd ../.. git add libs/thirdparty git commit -m "更新子模塊 thirdparty 到最新版本"
批量更新所有子模塊
git submodule foreach git pull
5. 刪除子模塊
刪除子模塊條目：
git rm -f libs/thirdpackage
刪除 .git/modules/thirdparty 目錄（手動操作）：
rm -rf .git/modules/libs/thirdpackage
提交變更：
git commit -m "移除子模塊 thirdpackage"
注意事項
- 路徑?jīng)_突：確保目標(biāo)路徑為空，否則會報錯
'<路徑>' already exists。 - 子模塊獨立性：子模塊的修改需在子模塊目錄內(nèi)單獨提交，主倉庫僅記錄其提交 ID。
- 分支跟蹤：默認子模塊處于“游離 HEAD”狀態(tài)，如需跟蹤分支，需手動切換：
cd libs/thirdparty git checkout main
通過以上步驟，你可以將外部倉庫作為子模塊嵌入主項目，并管理其版本和更新。
到此這篇關(guān)于在Git中添加子模塊(submodule)的詳細步驟的文章就介紹到這了,更多相關(guān)Git添加子模塊submodule內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
Scratch3.0 頁面初始化同時加載sb3文件的操作代碼
今天通過本文給大家分享Scratch3.0 頁面初始化同時加載sb3文件的操作代碼，感興趣的朋友一起看看吧2021-08-08
這篇文章主要介紹了使用Git上傳本地倉庫到github倉庫的實現(xiàn)方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-06-06
FFmpeg是一套可以用來記錄、轉(zhuǎn)換數(shù)字音頻、視頻，并能將其轉(zhuǎn)化為流的開源計算機程序?？梢暂p易地實現(xiàn)多種視頻格式之間的相互轉(zhuǎn)換，這篇文章主要介紹了音視頻基本概念和FFmpeg的簡單入門,需要的朋友可以參考下2022-04-04
中文分詞是做好中文內(nèi)容檢索、文本分析的基礎(chǔ)，主要應(yīng)用于搜索引擎與數(shù)據(jù)挖掘領(lǐng)域。中文是以詞為基本語素單位，而詞與詞之間并不像英語一樣有空格來分隔，因而中文分詞的難點在于如何準(zhǔn)確而又快速地進行分詞2012-11-11
本文介紹了解決Git代碼沖突的兩種方法：使用IntelliJ IDEA工具和Git命令行,通過對比不同分支的代碼差異,選擇有效代碼進行合并,在IntelliJ IDEA中,可以通過Merge功能解決沖突；在Git命令行中,需要手動編輯沖突文件并提交修改2025-11-11
這篇文章主要介紹了git如何使用Sourcetree合并多次本地提交記錄，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2023-05-05
Express 是一個簡潔而靈活的 node.js Web應(yīng)用框架, 提供了一系列強大特性幫助你創(chuàng)建各種 Web 應(yīng)用和豐富的 HTTP 工具，如果你不會jJava or Python等后端，使用 Express可以幫助我們快速地搭建一個完整功能的網(wǎng)站2021-08-08
這篇文章主要介紹了Jenkins?腳本命令行應(yīng)用總結(jié),包括批量刪除Jenkins 項目構(gòu)建記錄，非多分支項目及分支項目，文章結(jié)合示例代碼給大家介紹的非常詳細，需要的朋友可以參考下2022-04-04
.gitignore文件用于指定在git中應(yīng)該被忽略的文件或目錄,前端的node_modules目錄包含大量文件,如果將其添加到版本管理系統(tǒng)中,會使倉庫變得龐大,不利于倉庫的管理,本文介紹了使用.gitignore文件來簡化你的Git倉庫管理2023-10-10
所謂BOM，全稱是Byte Order Mark，它是一個Unicode字符，通常出現(xiàn)在文本的開頭，用來標(biāo)識字節(jié)序（Big/Little Endian），除此以外還可以標(biāo)識編碼（UTF-8/16/32），如果出現(xiàn)在文本中間，則解釋為zero width no-break space。2011-09-09