1. 程式人生 > >版本號及使用npm管理專案版本號

版本號及使用npm管理專案版本號

版本號
語義化版本:https://semver.org/lang/zh-CN/
版本號格式:主版本號.次版本號.修訂號
版本號遞增規則:
- 主版本號:做了不相容修改或顛覆式的重寫
- 次版本號:向下相容的功能性新增
- 修訂號:向下相容的問題修正
先行版本號及版本編譯資訊可以加到“主版本號.次版本號.修訂號”的後面,作為延伸。

版本號只能增加,禁止下降,程式碼的修改必須以新版本形式更新;最初版本建議是從v0.1.0開始,0.x.y階段是基礎功能、公眾API開發階段。

1.0.0版本釋出時機:
- 被用於正式環境
- 穩定的API被使用者依賴
- 很擔心向下相容的問題

萬一不小心把一個不相容的改版當成了次版本號發行了該怎麼辦?一旦發現自己破壞了語義化版本控制的規範,就要修正這個問題,併發行一個新的次版本號來更正這個問題並且恢復向下相容。即使是這種情況,也不能去修改已發行的版本。

npm管理專案版本號
在命令列視窗輸入npm version ?可以檢視可以使用的命令:

major: 主版本號
premajor: 預備主版本
minor: 次版本號
preminor: 預備次版本
patch: 修訂號
prepatch: 預備修訂版
prerelease: 預釋出版本

執行命令及版本提升示例:

假設初始版本為0.1.0xxx git:(master) npm version preminor
v0.1.0-0xxx git:(master) npm version minor
v0.1.0xxx git:(master) npm version
prepatch v0.1.1-0xxx git:(master) npm version patch v0.1.1xxx git:(master) npm version prerelease v0.1.2-0xxx git:(master) npm version premajor v1.0.0-0xxx git:(master) npm version major v1.0.0

如果使用git進行專案管理,在進行版本提升前,需要將修改內容提交,即commit,然後再執行npm version xxx進行版本提升,版本提升會自動被提交到當前分支中,可以通過git log

進行檢視。

語義化版本控制規範

版本變更時機