为了保持 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.01.0.x~1.0.4
  • 次要版本: 11.x^1.0.4
  • 主要版本: *x

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

示例

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

资源