定義了公共API，你就可以透過修改相應(yīng)的版本號(hào)來向大家說明你的修改纠吴∮舶埃考慮使用這樣的版本號(hào)格式：XYZ （主版本號(hào).次版本號(hào).修訂號(hào)）修復(fù)問題但不影響API 時(shí)，遞增修訂號(hào)戴已；API 保持向下兼容的新增及修改時(shí)固该，遞增次版本號(hào)；進(jìn)行不向下兼容的修改時(shí)糖儡，遞增主版本號(hào)伐坏。
以下關(guān)鍵詞MUST、MUST NOT握联、REQUIRED桦沉、SHALL、SHALL NOT金闽、SHOULD纯露、SHOULD NOT、 RECOMMENDED代芜、MAY埠褪、OPTIONAL 依照RFC 2119 的敘述解讀。（譯注：為了保持語句順暢挤庇， 以下文件遇到的關(guān)鍵詞將依照整句語義進(jìn)行翻譯钞速，在此先不進(jìn)行個(gè)別翻譯。）
- 使用語義化版本控制的軟件“必須MUST”定義公共API罚随。該API可以在代碼中被定義或出現(xiàn)于嚴(yán)謹(jǐn)?shù)奈募?nèi)玉工。無論何種形式都應(yīng)該力求精確且完整。
- 標(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。
- 標(biāo)記版本號(hào)的軟件發(fā)行后糕殉，“禁止MUST NOT”改變?cè)摪姹拒浖膬?nèi)容亩鬼。任何修改都“必須MUST”以新版本發(fā)行殖告。
- 主版本號(hào)為零（0.yz）的軟件處于開發(fā)初始階段，一切都可能隨時(shí)被改變雳锋。這樣的公共API 不應(yīng)該被視為穩(wěn)定版黄绩。
- 1.0.0 的版本號(hào)用于界定公共API 的形成。這一版本之后所有的版本號(hào)更新都基于公共API 及其修改內(nèi)容玷过。
- 修訂號(hào)Z（xyZ | x > 0）“必須MUST”在只做了向下兼容的修正時(shí)才遞增爽丹。這里的修正指的是針對(duì)不正確結(jié)果而進(jìn)行的內(nèi)部修改。
- 次版本號(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”歸零。
- 主版本號(hào)X（Xyz | X > 0）“必須MUST”在有任何不兼容的修改被加入公共API時(shí)遞增飞蛹。其中“可以MAY”包括次版本號(hào)及修訂級(jí)別的改變谤狡。每當(dāng)主版本號(hào)遞增時(shí)灸眼，次版本號(hào)和修訂號(hào)“必須MUST”歸零卧檐。
- 先行版本號(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悄蕾。
- 版本編譯信息“可以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-9A-Za-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鸭廷。
- 版本的優(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)決定吱型。例如：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。
摘自：
https://leohxj.gitbooks.io/a-programmer-prepares/content/programmer-basic/semantic-versioning.html
