版本格式

版本格式:主版本號(hào).次版本號(hào).修訂號(hào)

版本號(hào)遞增規(guī)則如下:

  • 主版本號(hào):當(dāng)你做了不兼容的API 修改。
  • 次版本號(hào):當(dāng)你做了向下兼容的功能性新增。
  • 修訂號(hào):當(dāng)你做了向下兼容的問題修正。

先行版本號(hào)及版本編譯信息可以加到“主版本號(hào).次版本號(hào).修訂號(hào)”的后面快集,作為延伸定枷。


  1. 使用語義化版本控制的軟件“必須MUST”定義公共API。該API可以在代碼中被定義或出現(xiàn)
    于嚴(yán)謹(jǐn)?shù)奈募?nèi)暇唾。無論何種形式都應(yīng)該力求精確且完整。
  2. 標(biāo)準(zhǔn)的版本號(hào)“必須MUST”采用XYZ的格式辰斋, 其中X策州、Y和Z為非負(fù)的整數(shù),且“禁止MUST
    NOT”在數(shù)字前方補(bǔ)零宫仗。X是主版本號(hào)够挂、Y是次版本號(hào)、而Z為修訂號(hào)藕夫。每個(gè)元素“必須
    MUST”以數(shù)值來遞增孽糖。例如:1.9.1 -> 1.10.0 -> 1.11.0。
  3. 標(biāo)記版本號(hào)的軟件發(fā)行后毅贮,“禁止MUST NOT”改變?cè)摪姹拒浖膬?nèi)容办悟。任何修改都“必須
    MUST”以新版本發(fā)行。
  4. 主版本號(hào)為零(0.yz)的軟件處于開發(fā)初始階段滩褥,一切都可能隨時(shí)被改變病蛉。這樣的公共
    API 不應(yīng)該被視為穩(wěn)定版。
  5. 1.0.0 的版本號(hào)用于界定公共API 的形成。這一版本之后所有的版本號(hào)更新都基于公共
    API 及其修改內(nèi)容铺然。
  6. 修訂號(hào)Z(xyZ | x > 0)“必須MUST”在只做了向下兼容的修正時(shí)才遞增俗孝。這里的修正指的
    是針對(duì)不正確結(jié)果而進(jìn)行的內(nèi)部修改。
  7. 次版本號(hào)Y(xYz | x > 0)“必須MUST”在有向下兼容的新功能出現(xiàn)時(shí)遞增魄健。在任何公共
    API的功能被標(biāo)記為棄用時(shí)也“必須MUST”遞增驹针。也“可以MAY”在內(nèi)部程序有大量新功能或
    改進(jìn)被加入時(shí)遞增,其中“可以MAY”包括修訂級(jí)別的改變诀艰。每當(dāng)次版本號(hào)遞增時(shí)柬甥,修訂
    號(hào)“必須MUST”歸零。
  8. 主版本號(hào)X(Xyz | X > 0)“必須MUST”在有任何不兼容的修改被加入公共API時(shí)遞增其垄。其
    中“可以MAY”包括次版本號(hào)及修訂級(jí)別的改變苛蒲。每當(dāng)主版本號(hào)遞增時(shí),次版本號(hào)和修訂
    號(hào)“必須MUST”歸零绿满。
  9. 先行版本號(hào)“可以MAY”被標(biāo)注在修訂版之后臂外,先加上一個(gè)連接號(hào)再加上一連串以句點(diǎn)分隔
    的標(biāo)識(shí)符號(hào)來修飾。標(biāo)識(shí)符號(hào)“必須MUST”由ASCII碼的英數(shù)字和連接號(hào)[0-9A-Za-z-]組
    成喇颁,且“禁止MUST NOT”留白漏健。數(shù)字型的標(biāo)識(shí)符號(hào)“禁止MUST NOT”在前方補(bǔ)零。先行版
    的優(yōu)先級(jí)低于相關(guān)聯(lián)的標(biāo)準(zhǔn)版本橘霎。被標(biāo)上先行版本號(hào)則表示這個(gè)版本并非穩(wěn)定而且可能
    無法達(dá)到兼容的需求蔫浆。范例:1.0.0-alpha、1.0.0-alpha.1姐叁、 1.0.0-0.3.7瓦盛、1.0.0-
    x.7.z.92。
  10. 版本編譯信息“可以MAY”被標(biāo)注在修訂版或先行版本號(hào)之后外潜,先加上一個(gè)加號(hào)再加上一連
    串以句點(diǎn)分隔的標(biāo)識(shí)符號(hào)來修飾原环。標(biāo)識(shí)符號(hào)“必須MUST”由ASCII的英數(shù)字和連接號(hào)[0-9AZa-z-]組成,且“禁止MUST
    NOT”留白处窥。當(dāng)判斷版本的優(yōu)先層級(jí)時(shí)嘱吗,版本編譯信息“可
    SHOULD”被忽略。因此當(dāng)兩個(gè)版本只有在版本編譯信息有差別時(shí)滔驾,屬于相同的優(yōu)先層
    級(jí)谒麦。范例:1.0.0-alpha+001、1.0.0+20130313144700嵌灰、 1.0.0-beta+exp.sha.5114f85弄匕。
  11. 版本的優(yōu)先層級(jí)指的是不同版本在排序時(shí)如何比較颅悉。判斷優(yōu)先層級(jí)時(shí)沽瞭,“必須MUST”把版
    本依序拆分為主版本號(hào)、次版本號(hào)剩瓶、修訂號(hào)及先行版本號(hào)后進(jìn)行比較(版本編譯信息不
    在這份比較的列表中)驹溃。由左到右依序比較每個(gè)標(biāo)識(shí)符號(hào)城丧,第一個(gè)差異值用來決定優(yōu)先
    層級(jí):主版本號(hào)、次版本號(hào)及修訂號(hào)以數(shù)值比較豌鹤,例如1.0.0 < 2.0.0 < 2.1.0 < 2.1.1亡哄。當(dāng)
    主版本號(hào)、次版本號(hào)及修訂號(hào)都相同時(shí)布疙,改以優(yōu)先層級(jí)比較低的先行版本號(hào)決定蚊惯。例
    程序員的自我修養(yǎng)
    語義化版本 12
    如:1.0.0-alpha < 1.0.0。有相同主版本號(hào)灵临、次版本號(hào)及修訂號(hào)的兩個(gè)先行版本號(hào)截型,其優(yōu)
    先層級(jí)“必須MUST”透過由左到右的每個(gè)被句點(diǎn)分隔的標(biāo)識(shí)符號(hào)來比較,直到找到一個(gè)差
    異值后決定:只有數(shù)字的標(biāo)識(shí)符號(hào)以數(shù)值高低比較儒溉,有字母或連接號(hào)時(shí)則逐字以ASCII的
    排序來比較宦焦。數(shù)字的標(biāo)識(shí)符號(hào)比非數(shù)字的標(biāo)識(shí)符號(hào)優(yōu)先層級(jí)低。若開頭的標(biāo)識(shí)符號(hào)都相
    同時(shí)顿涣,欄 位比較多的先行版本號(hào)優(yōu)先層級(jí)比較高波闹。范例:1.0.0-alpha < 1.0.0-alpha.1 <
    1.0.0-alpha.beta < 1.0.0-beta < 1.0.0-beta.2 < 1.0.0-beta.11 < 1.0.0- rc.1 < 1.0.0。@

忘了附帶鏈接了涛碑,有空加

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末精堕,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子蒲障,更是在濱河造成了極大的恐慌锄码,老刑警劉巖,帶你破解...
    沈念sama閱讀 212,080評(píng)論 6 493
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件晌涕,死亡現(xiàn)場(chǎng)離奇詭異滋捶,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)余黎,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,422評(píng)論 3 385
  • 文/潘曉璐 我一進(jìn)店門重窟,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人惧财,你說我怎么就攤上這事巡扇。” “怎么了垮衷?”我有些...
    開封第一講書人閱讀 157,630評(píng)論 0 348
  • 文/不壞的土叔 我叫張陵厅翔,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我搀突,道長(zhǎng)刀闷,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 56,554評(píng)論 1 284
  • 正文 為了忘掉前任,我火速辦了婚禮甸昏,結(jié)果婚禮上顽分,老公的妹妹穿的比我還像新娘。我一直安慰自己施蜜,他們只是感情好卒蘸,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,662評(píng)論 6 386
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著翻默,像睡著了一般缸沃。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上修械,一...
    開封第一講書人閱讀 49,856評(píng)論 1 290
  • 那天和泌,我揣著相機(jī)與錄音,去河邊找鬼祠肥。 笑死武氓,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的仇箱。 我是一名探鬼主播县恕,決...
    沈念sama閱讀 39,014評(píng)論 3 408
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼剂桥!你這毒婦竟也來了忠烛?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 37,752評(píng)論 0 268
  • 序言:老撾萬榮一對(duì)情侶失蹤权逗,失蹤者是張志新(化名)和其女友劉穎美尸,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體斟薇,經(jīng)...
    沈念sama閱讀 44,212評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡师坎,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,541評(píng)論 2 327
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了堪滨。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片胯陋。...
    茶點(diǎn)故事閱讀 38,687評(píng)論 1 341
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖袱箱,靈堂內(nèi)的尸體忽然破棺而出遏乔,到底是詐尸還是另有隱情,我是刑警寧澤发笔,帶...
    沈念sama閱讀 34,347評(píng)論 4 331
  • 正文 年R本政府宣布盟萨,位于F島的核電站,受9級(jí)特大地震影響了讨,放射性物質(zhì)發(fā)生泄漏捻激。R本人自食惡果不足惜制轰,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,973評(píng)論 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望铺罢。 院中可真熱鬧艇挨,春花似錦残炮、人聲如沸韭赘。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,777評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽泉瞻。三九已至,卻和暖如春苞冯,著一層夾襖步出監(jiān)牢的瞬間袖牙,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,006評(píng)論 1 266
  • 我被黑心中介騙來泰國(guó)打工舅锄, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留鞭达,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 46,406評(píng)論 2 360
  • 正文 我出身青樓皇忿,卻偏偏與公主長(zhǎng)得像畴蹭,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子鳍烁,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,576評(píng)論 2 349

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

  • 語義化版本 2.0.0摘要版本格式:主版本號(hào).次版本號(hào).修訂號(hào)叨襟,版本號(hào)遞增規(guī)則如下:主版本號(hào):當(dāng)你做了不兼容的 A...
    benguo閱讀 241評(píng)論 0 1
  • 語義化版本 2.0.0 摘要 版本格式:主版本號(hào).次版本號(hào).修訂號(hào),版本號(hào)遞增規(guī)則如下: 1.主版本號(hào):當(dāng)你做了不...
    24c41111e47b閱讀 328評(píng)論 0 0
  • 轉(zhuǎn)自 Semantic Versioning 2.0.0 RFC 2119 (Request for Commen...
    i云哲閱讀 2,061評(píng)論 0 6
  • 原文地址:http://semver.org/lang/zh-CN/ 摘要 版本格式:主版本號(hào).次版本號(hào).修訂號(hào)幔荒,...
    yuditxj閱讀 267評(píng)論 0 0
  • 歡迎前往個(gè)人博客 駑馬點(diǎn)滴 和視頻空間 嗶哩嗶哩-《挨踢日志》 聲明 此文為轉(zhuǎn)載糊闽,原文參見語義化版本 2.0.0 ...
    KomalZheng閱讀 222評(píng)論 0 0