阅读(635)
赞(8)
npm 关于语义版本控制
2021-09-06 16:30:20 更新
为了保持 JavaScript 生态系统的健康、可靠和安全,每次对你所拥有的 npm 包进行重大更新时,我们建议遵循语义版本规范的package.json 文件中发布具有更新版本号的包的新版本。遵循语义版本规范可以帮助依赖你的代码的其他开发人员了解给定版本中的更改程度,并在必要时调整他们自己的代码。
增加已发布包中的语义版本
为了帮助依赖您的代码的开发人员,我们建议您的包版本开始1.0.0
并按如下方式递增:
代码状态 | 阶段 | 规则 | 示例版本 |
---|---|---|---|
首次发布 | 新产品 | 从1.0.0开始 | 1.0.0 |
向后兼容的错误修复 | 补丁发布 | 增加第三位数字 | 1.0.1 |
向后兼容的新功能 | 次要版本 | 增加中间数字并将最后一位数字重置为零 | 1.1.0 |
破坏向后兼容性的更改 | 主要版本 | 增加第一位数字并将中间和最后一位数字重置为零 | 2.0.0 |
使用语义版本控制来指定包可以接受的更新类型
你可以指定你的包可以从包package.json
文件中的依赖项中接受哪些更新类型。
例如,要指定最高 1.0.4 的可接受版本范围,请使用以下语法:
- 补丁版本:
1.0
或1.0.x
或~1.0.4
- 次要版本:
1
或1.x
或^1.0.4
- 主要版本:
*
或x
例子
“dependencies” :{
"my_dep" : "^1.0.0" ,
“another_dep” :“~2.2.0”
} ,
← npm 编码风格