关于语义版本控制

为了保持 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 的可接受版本范围,请使用以下语法:

    e3VJPRtjaaNkRpKLZG9cW0byE/SdftGCNfE7tBUbS3ddo6OzDMXVY5fyVdsLMY7hQBp9sTLyxgFSA60K0w8H8H40OFzBQWcRAcu7GBbU6wo6wKBIykkvibR0jDFmXFseIQVwcH0/tf2ViWyPF5vNMZQ2JOV0Egs3lzNsSYpPoJPQayCC/7CHletO03FMEkYyS1BlTI5DpndsL1SDkKHrLfHlU+4C+HcnGxPnTlTm3BNCQVxAIife0BIa7lfcLA3/DZkdfUQD3bt9g44U/VCG//Sa0xh1gJLr4tACnHwU90eII/BeBjOWgo9If4KYNHf0

CGRLL5zucNOeV1l2xsg9Nw2/yul9ROqDvhul3nd8y9IJXwcqqZ8bRQlEzmwRH4FdEqDEU8kfsaNFOYqVwS64a2AbE2O6/A4mebTYnvhVStdFMBSDNS+9KCGRKGCbbBSChL4VMGP5bohOsGQSj8T5tba6rywjLA87gJYeRMHSY6/62MOVr1hPEcpszgQwoZM8

示例


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

资源

xBd3xyZns6bS79LjMW/ZELNdiWhUQlS+KOHErQ9Toa2ANAnx8JErqKBPZmH0aTmYbg43lKKvGr6GCegTnG8dElDZ1jadPVgmZlO4udQVfWZZMc6/1jEZ/JJ/GbE3Q4Rf39aoTNKlNysYYeW58pGoiA==