git規(guī)范

導(dǎo)讀

為了避免歧義揭朝,文檔大量使用了「能愿動詞」,對應(yīng)的解釋如下:

  • 必須(Must) - 只能這樣子做色冀,請無條件遵循潭袱,沒有別的選項(xiàng);
  • 絕不(Must Not)- 嚴(yán)令禁止锋恬,在任何情況下都不能這樣做屯换;
  • 應(yīng)該(Should) - 強(qiáng)烈建議這樣做,但是不強(qiáng)求与学;
  • 不應(yīng)該(Should Not) - 強(qiáng)烈建議不這樣做彤悔,但是不強(qiáng)求;
  • 可以(May) - 選擇性高一點(diǎn)

參考:RFC 2119

branch

長期分支
  • master —— 主分支索守,同時(shí)也必須是線上最新代碼的分支晕窑。

  • dev —— 開發(fā)人員的基礎(chǔ)分支,所有的開發(fā)功能分支(feat)都必須從dev分支上進(jìn)行拉取卵佛,同時(shí)也要合并到dev分支杨赤。

  • test —— 測試分支敞斋,應(yīng)該將dev分支合并到測試分支,進(jìn)行功能的測試疾牲,如果沒有問題植捎,再將test分支合并到master上,進(jìn)行新功能的上線说敏。

短期分支
  • hotfixes —— 緊急分支鸥跟,用于修改master分支上的錯(cuò)誤,修改后必須將此分支合并到master和dev分支盔沫。
  • feature —— 功能分支医咨,功能分支必須從dev分支切出,完成后提交pr架诞,review后必須合并到dev拟淮。
  • fix —— bug分支,用與修改非生產(chǎn)環(huán)境出現(xiàn)的bug谴忧。
分支規(guī)范
feature分支

feature分支命名必須遵循feature-{yourname}/{featurename}

hotfixes分支

hotfixes分支命名必須遵循h(huán)otfix-{yourname}/{hotfixname}

fix分支

fix分支命名必須遵循fix-{yourname}/{fixname}#{issuse}

*注:

  • yourname —— 姓名
  • featurename —— 功能分支名
  • hotfixes —— 緊急分支名
  • fix —— bug分支名

commit

commit分類
  • feat —— 功能很泊,feat: 添加登陸功能
  • fix —— bug,fix: 修改登錄接口錯(cuò)誤
  • hotfix —— 緊急沾谓,hotfix: 修改生產(chǎn)環(huán)境登錄接口錯(cuò)誤
  • docs —— 文檔委造,docs: 修改README
  • style —— 不影響代碼含義的更改(空格、格式均驶、缺少分號等)style: 刪除空格昏兆,刪除console
  • perf —— 提高性能的代碼更改 perf: 優(yōu)化打包后的文件大小
  • test —— 添加缺失測試或糾正現(xiàn)有測試 test: 添加對什么方法為0的單元測試
  • build —— 影響生成系統(tǒng)或外部依賴項(xiàng)的更改(示例范圍:gulp、broccoli妇穴、npm)build: 修改webpack打包配置 / build: 添加js-cookies包
  • ci —— 對CI配置文件和腳本的更改 ci: 修改xxx.yaml文件
  • chore —— 其他不修改src或測試文件的更改爬虱,如在根目錄下的其他文件 chore: 修改時(shí)間格式化函數(shù)
  • refactor —— 既不修復(fù)錯(cuò)誤也不添加功能的代碼更改 refactor: 添加.gitignore
  • revert —— 還原以前的提交 revert: #62

pull request

  • pr必須提交到dev分支,并由組長或項(xiàng)目管理人員進(jìn)行review后沒有問題進(jìn)行合并
  • pr遇到?jīng)_突時(shí)腾它,必須應(yīng)該自己解決
  • pr可以簡述功能信息

merge

  • dev分支

    代碼通過提交pr(同時(shí)寫明信息)后跑筝,必須有至少一個(gè)人進(jìn)行review,review后沒有問題可以合并到dev分支

  • hotfix分支

    代碼應(yīng)從master分支切出瞒滴,修改完成后必須提交兩個(gè)pr分別到master和dev曲梗,在reviewer審查沒問題后合并到master和dev

  • fix分支

    代碼從dev分支切出,在修改完成后必須提交pr(同時(shí)寫明信息)后妓忍,在reviewer審查沒問題后合并到dev

  • feat分支

    代碼從dev分支切出虏两,在功能完成后必須提交pr(同時(shí)寫明信息)后,在reviewer審查沒問題后合并到dev

  • test分支

    代碼必須從dev分支合并進(jìn)來

tag

格式:vx.y.z单默,如v1.0.0碘举。其中x代表主版本號,y代表次版本號搁廓,z代表補(bǔ)丁號

如果只修改了bug則對z進(jìn)行加一

新增功能引颈,向下兼容耕皮,沒有刪除功能對y進(jìn)行加一

不向下兼容,刪除功能對x進(jìn)行加一

  • master分支

    master分支在每次更新生產(chǎn)環(huán)境時(shí)必須打tag蝙场,同時(shí)也可以標(biāo)注出基本信息

注意事項(xiàng)

  • 絕不能直接提交代碼到master凌停,dev,test分支
  • 必須有一個(gè)reviewer
  • 合并到master和test應(yīng)由reviewer進(jìn)行
  • 除master售滤,dev罚拟,test分支,其他所有分支應(yīng)該在使用完成后進(jìn)行銷毀刪除
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末完箩,一起剝皮案震驚了整個(gè)濱河市赐俗,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌弊知,老刑警劉巖阻逮,帶你破解...
    沈念sama閱讀 219,039評論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異秩彤,居然都是意外死亡叔扼,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,426評論 3 395
  • 文/潘曉璐 我一進(jìn)店門漫雷,熙熙樓的掌柜王于貴愁眉苦臉地迎上來瓜富,“玉大人,你說我怎么就攤上這事降盹∮敫蹋” “怎么了?”我有些...
    開封第一講書人閱讀 165,417評論 0 356
  • 文/不壞的土叔 我叫張陵澎现,是天一觀的道長仅胞。 經(jīng)常有香客問我每辟,道長剑辫,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,868評論 1 295
  • 正文 為了忘掉前任渠欺,我火速辦了婚禮妹蔽,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘挠将。我一直安慰自己胳岂,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,892評論 6 392
  • 文/花漫 我一把揭開白布舔稀。 她就那樣靜靜地躺著乳丰,像睡著了一般。 火紅的嫁衣襯著肌膚如雪内贮。 梳的紋絲不亂的頭發(fā)上产园,一...
    開封第一講書人閱讀 51,692評論 1 305
  • 那天汞斧,我揣著相機(jī)與錄音,去河邊找鬼什燕。 笑死粘勒,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的屎即。 我是一名探鬼主播庙睡,決...
    沈念sama閱讀 40,416評論 3 419
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼技俐!你這毒婦竟也來了乘陪?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,326評論 0 276
  • 序言:老撾萬榮一對情侶失蹤雕擂,失蹤者是張志新(化名)和其女友劉穎暂刘,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體捂刺,經(jīng)...
    沈念sama閱讀 45,782評論 1 316
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡谣拣,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,957評論 3 337
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了族展。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片森缠。...
    茶點(diǎn)故事閱讀 40,102評論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖仪缸,靈堂內(nèi)的尸體忽然破棺而出贵涵,到底是詐尸還是另有隱情,我是刑警寧澤恰画,帶...
    沈念sama閱讀 35,790評論 5 346
  • 正文 年R本政府宣布宾茂,位于F島的核電站,受9級特大地震影響拴还,放射性物質(zhì)發(fā)生泄漏跨晴。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,442評論 3 331
  • 文/蒙蒙 一片林、第九天 我趴在偏房一處隱蔽的房頂上張望端盆。 院中可真熱鬧,春花似錦费封、人聲如沸焕妙。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,996評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽焚鹊。三九已至,卻和暖如春韧献,著一層夾襖步出監(jiān)牢的瞬間末患,已是汗流浹背爷抓。 一陣腳步聲響...
    開封第一講書人閱讀 33,113評論 1 272
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留阻塑,地道東北人蓝撇。 一個(gè)月前我還...
    沈念sama閱讀 48,332評論 3 373
  • 正文 我出身青樓,卻偏偏與公主長得像陈莽,于是被迫代替她去往敵國和親渤昌。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,044評論 2 355