semver 語(yǔ)義化版本規(guī)范

semver

semver 簡(jiǎn)介


semver 是 語(yǔ)義化版本(Semantic Versioning)規(guī)范 的一個(gè)實(shí)現(xiàn)厦章,目前是由 npm 的團(tuán)隊(duì)維護(hù),實(shí)現(xiàn)了版本和版本范圍的解析照藻、計(jì)算袜啃、比較。

semver 的兩個(gè)概念


  • 固定版本:是指例如 0.4.1幸缕、1.2.7群发、1.2.4-beta.0 這樣表示包的特定版本的字符串。
  • 范圍版本:是對(duì)滿足特定規(guī)則的版本的一種表示发乔,例如 1.2.3-2.3.4熟妓、1.x、^0.2栏尚、>1.4.

版本號(hào)格式


主版本號(hào)[MAJOR].次版本號(hào)[MINOR].修訂號(hào)[PATCH]起愈,版本號(hào)遞增規(guī)則如下:

  1. 主版本號(hào):當(dāng)做了不兼容的 API 修改,
  2. 次版本號(hào):當(dāng)做了向下兼容的功能性新增译仗,
  3. 修訂號(hào):當(dāng)做了向下兼容的問(wèn)題修正抬虽。

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

當(dāng)主版本號(hào)升級(jí)后阐污,次版本號(hào)和修訂號(hào)需要重置為0,次版本號(hào)進(jìn)行升級(jí)后咱圆,修訂版本需要重置為0笛辟。

先行版本號(hào)(Pre-release Version)

先行版本號(hào)可以作為發(fā)布正式版之前的版本功氨,格式是在修訂版本號(hào)后面加上一個(gè)連接號(hào)(-),再加上一連串以點(diǎn)(.)分割的標(biāo)識(shí)符隘膘,標(biāo)識(shí)符可以由英文、數(shù)字和連接號(hào)([0-9A-Za-z-])組成杠览。example:

1.0??.0-alpha
1.0.0-alpha.1
1.0.0-0.3.7
1.0.0-x.7.z.92

以下是一些常見的先行版本號(hào)名稱:

  • alpha:是內(nèi)部測(cè)試版,一般不向外部發(fā)布,會(huì)有很多Bug.一般只有測(cè)試人員使用弯菊。
  • beta:也是測(cè)試版,這個(gè)階段的版本會(huì)一直加入新的功能踱阿。在Alpha版之后推出
  • rc:Release Candidate) 系統(tǒng)平臺(tái)上就是發(fā)行候選版本管钳。RC版不會(huì)再加入新的功能了,主要著重于除錯(cuò)软舌。

定義依賴版本號(hào)


npm 的依賴的規(guī)則中才漆,還有 ~>佛点、<醇滥、=>=超营、<=鸳玩、-||演闭、x不跟、X* 等符號(hào)米碰;當(dāng)使用 npm install XX 時(shí)窝革,被安裝的依賴的版本號(hào)前會(huì)默認(rèn)加上 ^ 符號(hào)。

  • ^ :表示同一主版本號(hào)中吕座,不小于指定版本號(hào)的版本號(hào)
 `^2.2.1` 對(duì)應(yīng)主版本號(hào)為 2虐译,不小于 `2.2.1` 的版本號(hào),比如 `2.2.1`吴趴、`2.2.2`菱蔬、`2.3.0` ,主版本號(hào)固定
// 當(dāng)該依賴有最新版本時(shí)(eg:2.3.3),npm install 會(huì)安裝最新的依賴
  • ~ :表示同一主版本號(hào)和次版本號(hào)中史侣,不小于指定版本號(hào)的版本號(hào)
 `~2.2.1` 對(duì)應(yīng)主版本號(hào)為 2拴泌,次版本號(hào)為 2,不小于 `2.2.1` 的版本號(hào)惊橱,比如 `2.2.1蚪腐、2.2.2`,主版本號(hào)和次版本號(hào)固定
  • >税朴、<回季、=家制、>=<=泡一、-:用來(lái)指定一個(gè)版本號(hào)范圍
 `>2.1`
 `1.0.0 - 1.2.0`
//注意使用 `-` 的時(shí)候颤殴,必須兩邊都有空格。
  • ||:表示或
 `^2 <2.2 || > 2.3`
  • x鼻忠、X涵但、*:表示通配符
 `*` 對(duì)應(yīng)所有版本號(hào)
 `3.x` 對(duì)應(yīng)所有主版本號(hào)為 3 的版本號(hào)

npm 中 package-lock.json 的一些坑


在 npm install 后,會(huì)生成一個(gè) package-lock.json 文件用于保存當(dāng)前安裝依賴的各種來(lái)源及版本號(hào)帖蔓。

在 npm 5.4.2版本后矮瘟,package-lock.json 的變動(dòng)規(guī)則:

  • 當(dāng)在 install dependency 的指定版本時(shí),會(huì)自動(dòng)更新 package-lock.json 文件中該 dependency 的 version 到指定的 version
  • 當(dāng)在 install dependency 的范圍版本時(shí)塑娇,當(dāng)前的 version 低于or等于 package-lock.json 文件中對(duì)應(yīng)的 dependency 的 version 時(shí)澈侠,會(huì)安裝 package-lock.json 中的 version;
package.json
"antd": "^3.6.1", // eg:最新版本是 3.9.4

package-lock.json
"antd": "3.7.1",

執(zhí)行npm install 會(huì)安裝 3.7.1 版本

如果高于 package-lock.json 中對(duì)應(yīng)的 dependency 的 version 時(shí)埋酬,會(huì)安裝當(dāng)前范圍版本號(hào)中最高的版本哨啃,會(huì)更新 package-lock.json 文件中對(duì)應(yīng)的版本號(hào);

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末写妥,一起剝皮案震驚了整個(gè)濱河市棘催,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌耳标,老刑警劉巖醇坝,帶你破解...
    沈念sama閱讀 206,311評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異次坡,居然都是意外死亡呼猪,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,339評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門砸琅,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)宋距,“玉大人,你說(shuō)我怎么就攤上這事症脂⊙枋辏” “怎么了?”我有些...
    開封第一講書人閱讀 152,671評(píng)論 0 342
  • 文/不壞的土叔 我叫張陵诱篷,是天一觀的道長(zhǎng)壶唤。 經(jīng)常有香客問(wèn)我,道長(zhǎng)棕所,這世上最難降的妖魔是什么闸盔? 我笑而不...
    開封第一講書人閱讀 55,252評(píng)論 1 279
  • 正文 為了忘掉前任,我火速辦了婚禮琳省,結(jié)果婚禮上迎吵,老公的妹妹穿的比我還像新娘躲撰。我一直安慰自己,他們只是感情好击费,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,253評(píng)論 5 371
  • 文/花漫 我一把揭開白布拢蛋。 她就那樣靜靜地躺著,像睡著了一般蔫巩。 火紅的嫁衣襯著肌膚如雪谆棱。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,031評(píng)論 1 285
  • 那天批幌,我揣著相機(jī)與錄音础锐,去河邊找鬼嗓节。 笑死荧缘,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的拦宣。 我是一名探鬼主播截粗,決...
    沈念sama閱讀 38,340評(píng)論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼鸵隧!你這毒婦竟也來(lái)了绸罗?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 36,973評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤豆瘫,失蹤者是張志新(化名)和其女友劉穎珊蟀,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體外驱,經(jīng)...
    沈念sama閱讀 43,466評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡育灸,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,937評(píng)論 2 323
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了昵宇。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片磅崭。...
    茶點(diǎn)故事閱讀 38,039評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖瓦哎,靈堂內(nèi)的尸體忽然破棺而出砸喻,到底是詐尸還是另有隱情,我是刑警寧澤蒋譬,帶...
    沈念sama閱讀 33,701評(píng)論 4 323
  • 正文 年R本政府宣布割岛,位于F島的核電站,受9級(jí)特大地震影響犯助,放射性物質(zhì)發(fā)生泄漏蜂桶。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,254評(píng)論 3 307
  • 文/蒙蒙 一也切、第九天 我趴在偏房一處隱蔽的房頂上張望扑媚。 院中可真熱鬧腰湾,春花似錦、人聲如沸疆股。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,259評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)旬痹。三九已至附井,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間两残,已是汗流浹背永毅。 一陣腳步聲響...
    開封第一講書人閱讀 31,485評(píng)論 1 262
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留人弓,地道東北人沼死。 一個(gè)月前我還...
    沈念sama閱讀 45,497評(píng)論 2 354
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像崔赌,于是被迫代替她去往敵國(guó)和親意蛀。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,786評(píng)論 2 345

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