关于语义版本控制
为了保持 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==