当前位置: 首页>后端>正文

npm 包版本语义化命名规范

所谓规范也只是一种约定,并没有强制性要求,如果大家都按照这种规范行事,那么环境就会变得秩序井然。如果大家都我行我素,失去了一个衡量标准,就会带来混乱。
版本语义化命名(semantic versioning)是npm官网推出的约定,希望大家在发布自己的包时能够遵守此规范。
包的版本号由两个分割点和三段数字构成,例如: 1.0.0。第一个数字是大版本号,第二个数字是次版本号,第三个数字是版本尾号。当你的包第一次发布时应该命名为 1.0.0,也有很多非正式版的包起始版本号是 0.x.x。之后如果作者只是修复了一些bug,更新后仅修改版本尾号;如果作者添加了一些方法、接口、函数,那么仅修改次版本号;如果整个包有较大的调整,甚至于是用法与以前大不相同(即原写法已经不可用的情况),那么就该修改大版本号了。

在 package.json 文件里的依赖包写法简介:

dependencies:{
  "demopackage1": "1.0.0"
}

这样写的意思是固定包的版本号,仅使用 1.0.0 版本,不随npm install自动更新。

dependencies:{
  "demopackage1": "1.0"
}

或者

dependencies:{
  "demopackage1": "1.0.x"
}

又或者

dependencies:{
  "demopackage1": "~1.0.4"
}

这样写的意思是固定包的大版本号和次版本号,使用 1.0.x 版本,npm install自动更新至最新的1.0.x版本。

同理可得:

dependencies:{
  "demopackage1": "1"
}

或者

dependencies:{
  "demopackage1": "1.x"
}

又或者

dependencies:{
  "demopackage1": "^1.0.4"
}

这样写的意思是固定包的大版本号,使用 1.x 版本,npm install自动更新至最新的1.x版本。

以上内容来自作者对npm官网的解读,如有谬误,欢迎指正。


https://www.xamrdz.com/backend/3ks1927210.html

相关文章: