About semantic versioning

为了保持JavaScript生态系统的健康,可靠和安全,每次对拥有的npm软件包进行重大更新时,建议您在package.json文件中发布包含语义版本控制的新版本的软件包,其中包含更新的版本号package.json 规格 . 遵循语义版本规范可以帮助其他依赖您代码的开发人员了解给定版本中更改的程度,并在必要时调整自己的代码.

注意:如果您引入的更改打破了对软件包的依赖性,我们强烈建议您增加版本主编号 ; 有关详情,请参见下文.

Incrementing semantic versions in published packages

为了帮助依赖于您的代码的开发人员,我们建议您从1.0.0版开始安装软件包,并按如下所示递增:

代码状态 Stage Rule 示例版本
初版 新产品 从1.0.0开始 1.0.0
向后兼容的错误修复 补丁发布 递增第三位数 1.0.1
向后兼容的新功能 轻微释放 递增中间数字并将最后一位重置为零 1.1.0
更改会破坏向后兼容性 主要发行 递增第一位并将中间和最后一位重置为零 2.0.0

Using semantic versioning to specify update types your package can accept

您可以从软件包的package.json文件中的依赖关系中指定软件包可以接受的更新类型.

例如,要指定可接受的最高版本范围为1.0.4,请使用以下语法:

有关语义版本语法的更多信息,请参见npm semver计算器 .

Example


"dependencies": {
  "my_dep": "^1.0.0",
  "another_dep": "~2.2.0"
},

Resources


< Specifying dependencies and devDependencies in a package.json file | Adding dist-tags to packages >

by  ICOPY.SITE