版本號及使用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進行查看。

語義化版本控制規範

版本變更時機

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章