使用git subtree & submodule管理多個子項目

本文首發(fā)在segmentfault中

背景

最近工作中遇到了一個問題:隨著項目越來越多沸停,很多項目依賴同一個模板或是配置文件想同一管理典阵,又不想分開維護,所以只能互相引用碟案,或是各自維護,導(dǎo)致了后續(xù)的很多麻煩颇蜡。

場景一:?很多公司手機端和pc同時開發(fā)价说,引用同一套模板辆亏,或者通用的組件庫。

場景二:用gulp鳖目、webpack來打包扮叨,或是用node來開發(fā)會有一些通用的配置文件需要統(tǒng)一管理。

第一階段:gulp等自動化工具手動同步


這個是我們最初使用的方法领迈,比如有兩個項目projectA和projectB彻磁,B項目依賴A項目中的一套模板。

問題1:開發(fā)中我們引用模塊的時候狸捅,B項目要經(jīng)過很長的路徑引用才能引到A項目中的模板衷蜓,這要求所有開發(fā)者本地文件路徑保持高度一致。

問題2:使用webpack打包壓縮靜態(tài)文件的時候尘喝,A磁浇、B兩個項目必須在同一個git分支,很容易搞亂朽褪。

問題3:修改完文件不能及時看到效果置吓,還要手動同步一次。這點是開發(fā)中最致命的問題鞍匾,做前端的都會有體會如果改了一個樣式或是一個模板要通過一個很長的操作路徑才能看到效果交洗,是非常影響開發(fā)效率的。

結(jié)論:在用了幾個月之后橡淑,各種問題暴露出來构拳,我們必須找新的辦法。

第二階段:使用Git subtree

網(wǎng)上調(diào)研了很多方法梁棠,例如[git submodule](http://git-scm.com/book/en/v1/Git-Tools-Submodules)置森,第二階段最終選擇了subtree,一是官網(wǎng)已經(jīng)不再推薦使用submodule了符糊,二是subtree實在是太方便易用了凫海。(后來和同事商量了下發(fā)現(xiàn)submodule還是有使用價值的,在第三階段中我們再分析男娄。)

說到subtree易用行贪,只需要2步就可以初始化好一個子項目:

第一步:添加遠程倉庫

語法:`git remote add -f <子倉庫名> <子倉庫地址>`

實例:`git remote add -f component git@xxx.git`

驗證:`git remote -v` 可以看到已經(jīng)你添加成功了一個新的遠程倉庫叫 `component `

第二步:創(chuàng)建本地目錄

語法:`git subtree add --prefix=<子目錄名> <子倉庫名> <分支> --squash`

實例:`git subtree add --prefix=component component master --squash`

這時候會在本地新建一個叫 `component` 的文件夾,`--squash ` 會把subtree上的改動合并成一次commit

第三步:使用 ( pull & push )

pull:`git subtree pull --prefix=component component master --squash`

push:`git subtree push --prefix=component component master --squash`

注意:**必須在 `component` 的父級目錄執(zhí)行**模闲,使用起來還不是很方便建瘫。

第四步:更方便的使用

可以在 `package.json` 里面加script語句來執(zhí)行,這樣在每個文件夾下都可以pull & push尸折,強制統(tǒng)一啰脚,避免出錯。

第三階段:使用Git submodule

1. 添加:`git submodule add`

2. 添加后會在當(dāng)前目錄下生成一個 `.gitmodules ` 的新文件实夹,里面會記錄submodule的引用信息橄浓,在當(dāng)前項目的位置以及倉庫的url粒梦。

3.? `git submodule foreach git pull` 這樣可以更新所有子模塊。

這里只介紹了最基本的submodule用法荸实,實際在多個項目中更新和修改submodule還是很多坑的匀们,可以參考這篇文章? [Git Submodule的坑]([http://blog.devtang.com/2013/05/08/git-submodule-issues/])。** 所以我們規(guī)定在項目中只能pull子模塊泪勒,修改的話只能到子模塊中去push昼蛀。** 這樣避免了多人修改造成的沖突宴猾。

結(jié)論

1.在新員工加入團隊時:一次性clone項目圆存,submodule可以一起clone出來,只需添加--recursive遞歸參數(shù)就可以了仇哆,而subtree并不行沦辙,只能手動添加,不過可以借助神器Yeoman(一個自動生成項目腳手架的工具)來實現(xiàn)讹剔。

2.subtree適合像配置文件這種需要跟著項目走的情況油讯。

3.submodule適合在開發(fā)階段時引用,到了生產(chǎn)環(huán)境會被打包到指定文件內(nèi)延欠,而本身并不用跟著版本走的情況陌兑。

參考文章

1. 官網(wǎng)文檔:Git Tools - Subtree Merging

2. 使用GIT SUBTREE集成項目到子目錄

3. 用 Git Subtree 在多個 Git 項目間雙向同步子項目,附簡明使用手冊

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末由捎,一起剝皮案震驚了整個濱河市兔综,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌狞玛,老刑警劉巖软驰,帶你破解...
    沈念sama閱讀 207,248評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異心肪,居然都是意外死亡锭亏,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,681評論 2 381
  • 文/潘曉璐 我一進店門硬鞍,熙熙樓的掌柜王于貴愁眉苦臉地迎上來慧瘤,“玉大人,你說我怎么就攤上這事固该」酰” “怎么了?”我有些...
    開封第一講書人閱讀 153,443評論 0 344
  • 文/不壞的土叔 我叫張陵蹬音,是天一觀的道長上煤。 經(jīng)常有香客問我,道長著淆,這世上最難降的妖魔是什么劫狠? 我笑而不...
    開封第一講書人閱讀 55,475評論 1 279
  • 正文 為了忘掉前任拴疤,我火速辦了婚禮,結(jié)果婚禮上独泞,老公的妹妹穿的比我還像新娘呐矾。我一直安慰自己,他們只是感情好懦砂,可當(dāng)我...
    茶點故事閱讀 64,458評論 5 374
  • 文/花漫 我一把揭開白布蜒犯。 她就那樣靜靜地躺著,像睡著了一般荞膘。 火紅的嫁衣襯著肌膚如雪罚随。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,185評論 1 284
  • 那天羽资,我揣著相機與錄音淘菩,去河邊找鬼。 笑死屠升,一個胖子當(dāng)著我的面吹牛潮改,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播腹暖,決...
    沈念sama閱讀 38,451評論 3 401
  • 文/蒼蘭香墨 我猛地睜開眼汇在,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了脏答?” 一聲冷哼從身側(cè)響起糕殉,我...
    開封第一講書人閱讀 37,112評論 0 261
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎以蕴,沒想到半個月后糙麦,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,609評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡丛肮,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,083評論 2 325
  • 正文 我和宋清朗相戀三年赡磅,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片宝与。...
    茶點故事閱讀 38,163評論 1 334
  • 序言:一個原本活蹦亂跳的男人離奇死亡焚廊,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出习劫,到底是詐尸還是另有隱情咆瘟,我是刑警寧澤,帶...
    沈念sama閱讀 33,803評論 4 323
  • 正文 年R本政府宣布诽里,位于F島的核電站袒餐,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜灸眼,卻給世界環(huán)境...
    茶點故事閱讀 39,357評論 3 307
  • 文/蒙蒙 一卧檐、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧焰宣,春花似錦霉囚、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,357評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至闪唆,卻和暖如春盅粪,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背苞氮。 一陣腳步聲響...
    開封第一講書人閱讀 31,590評論 1 261
  • 我被黑心中介騙來泰國打工湾揽, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人笼吟。 一個月前我還...
    沈念sama閱讀 45,636評論 2 355
  • 正文 我出身青樓,卻偏偏與公主長得像霸旗,于是被迫代替她去往敵國和親贷帮。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 42,925評論 2 344

推薦閱讀更多精彩內(nèi)容

  • 開發(fā)中我們經(jīng)常會遇到這樣的情況:項目越來越大诱告,一些通用的模塊我們希望將他抽離出來作為單獨的項目撵枢,以便其他項目也可以...
    feil0n9wan9閱讀 19,889評論 0 24
  • 本文作者陳云峰,轉(zhuǎn)載請注明精居。 這篇文章記錄個人常用的一些命令锄禽,和記不住的一些命令,轉(zhuǎn)載了并不斷更新靴姿。 Git官網(wǎng) ...
    陳云峰閱讀 2,806評論 0 24
  • 背景 項目A與項目B存在公用模塊沃但,在項目A中修改Bug或增加新功能需要同步到項目B中,由于存在區(qū)別所以還不能完全c...
    Archerlly閱讀 20,939評論 3 14
  • 本片內(nèi)容轉(zhuǎn)自CSDN http://blog.csdn.net/ithomer/article/details/7...
    五娃兒閱讀 4,917評論 2 88
  • 如下圖所示效果佛吓,可以使用表格實現(xiàn)宵晚,本文采用在CSS中實現(xiàn)。 標記如下: 在實例中维雇,有3個div淤刃,每列一個div,每...
    陸lmj閱讀 323評論 0 0