美文网首页npm 资源包管理器
npm 包版本语义化命名规范

npm 包版本语义化命名规范

作者: zbcy0012 | 来源:发表于2023-11-08 18:29 被阅读0次

    所谓规范也只是一种约定,并没有强制性要求,如果大家都按照这种规范行事,那么环境就会变得秩序井然。如果大家都我行我素,失去了一个衡量标准,就会带来混乱。
    版本语义化命名(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官网的解读,如有谬误,欢迎指正。

    相关文章

      网友评论

        本文标题:npm 包版本语义化命名规范

        本文链接:https://www.haomeiwen.com/subject/zbbqwdtx.html