npm 包版本号及管理

[chenyinkai]

版本号规则

一般版本号格式为 MAJOR.MINOR.PATCH：

• MAJOR：主版本号，当你做了不兼容的 API 修改。
• MINOR：次版本号，当你做了向下兼容的功能性新增。
• PATCH：修订号，当你做了向下兼容的问题修正。

一些其他的规则：

1. 任何时候都不能修改已发布的内容，任何修改都应该发布新版本。
2. 主版本号为 0 时，表示还处于开发阶段。
3. 主版本号递增时，次版本号和修订号清零；次版本号递增时，修订号清零。
4. 判断版本的优先级，必须拆分为拆分主版本号、次版本号、修订号进行比较，比如：1.0.0 < 2.0.0 < 2.1.0 < 2.1.1。
5. 先行版本号及版本编译元数据可以加到 “主版本号.次版本号.修订号” 的后面，作为延伸， 例如 1.0.0-alpha， 1.0.0-beta。

包版本管理

• ^ ：匹配指定主版本下所有更新版本
  • 主版本为 0，则匹配指定次版本下所有更新版本
• ~ ：匹配指定主版本，次版本下所有更新版本
• >=：大于等于指定版本
• <= ：小于等于指定版本
• 1.0.0 - 2.0.0：匹配 1.0.0 - 2.0.0 区间更新版本
• * 或 x 匹配所有主版本
• 1 或 1.x 匹配主版本号为 1 的所有版本
• 1.2 或 1.2.x 匹配版本号为 1.2 开头的所有版本

多条规则：

1. >=2.3.1 <=2.8.0：空格表示 「与」「且」的意思，表示同时满足两条规则。
2. >=2.3.1 || <=2.8.0：||表示 「或」的意思。

可以通过 npm semantic version calculator 这个网站查看匹配规则。

参考

语义化版本 2.0.0 | Semantic Versioning

2018 年了，你还是只会 npm install 吗？ - 掘金