npm 语义化版本控制

LogicCipher
• 阅读 16242

NPM 版本控制

为了在软件版本号中包含更多意义,反映代码所做的修改,产生了语义化版本,软件的使用者能从版本号中推测软件做的修改。npm 包使用语义化版控制,我们可安装一定版本范围的 npm 包,npm 会选择和你指定的版本相匹配(latest)最新版本安装。
npm 的版本号由三部分组成:
主版本号次版本号补丁版本号。变更不同的版本号,代表不同的意义:

  • 主版本号(major):软件做了不兼容的变更(breaking change 重大变更);
  • 次版本号(minor):添加功能或者废弃功能,向下兼容;
  • 补丁版本号(patch):bug 修复,向下兼容。

有时候为了表达更加确切的版本,还会在版本号后面添加标签或者扩展,来说明是预发布版本或者测试版本等。比如 3.2.3-beta-3

常见的标签有 :

标签意义补充
demodemo版本可能用于验证问题的版本
dev开发版开发阶段用的,bug 多,体积较大等特点,功能不完善
alphaα版本用于内部交流或者测试人员测试,bug较多
beta测试版(β版本)较α版本,有较大的改进,但是还是有bug
gamma(γ)伽马版本较α和β版本有很大的改进,与稳定版相差无几,用户可使用
trial试用版本本软件通常都有时间限制,过期之后用户如果希望继续使用,一般得交纳一定的费用进行注册或购买。有些试用版软件还在功能上做了一定的限制。
stable稳定版
csp内容安全版本js库常用
latest最新版本不指定版本和标签,npm 默认安最新版

更多关于标签的内容

查看标签:

npm dist-tags ls <pkg>
npm dist-tags ls vue

得到:

beta: 2.6.0-beta.3
csp: 1.0.28-csp
latest: 2.6.10

安装带标签的版本

npm i <pkg>@<tag>
npm i vue@beta # 安装 2.6.0-beta.3
希望安装带标签的版本,必须明确指定标签或者版本号,否则安装的是最新的不带标签的版本。

版本号变更规则

  1. 版本号只升不降,不得在数字前加0,比如 2.01.2 不允许的;
  2. 0.y.z,处于开发阶段的版本;
  3. 第一个正式版版本往往命名为 1.0.0;
  4. 先行版本必须在补丁版本之后添加,比如 2.3.7-0,0表示先行版本,和补丁版本用-分隔;
  5. 版本的比较依次比较主版本次版本补丁版本先行版本,直到第一个能得出比较结果为止;
  6. 不小心把一个不兼容的改版当成了次版本号发行了该怎么办?一旦发现自己破坏了语义化版本控制的规范,就要修正这个问题,并发行一个新的次版本号来更正这个问题并且恢复向下兼容。即使是这种情况,也不能去修改已发行的版本。

NPM版本计算器

如何处理即将弃用的功能?

弃用现存的功能是软件开发中的家常便饭,也通常是向前发展所必须的。但当你弃用公共API的一部分时,你应该做两件事:
(1)更新文档以便使用者知道这个变化。
(2)发行不包含弃用功能的次版本。在新主版本中完全移除弃用功能前,至少应有一个不包含弃用功能的次版本发布,以便使用者能够平滑过渡到新的API。

如何更新版本号?不用手动修改 package.json。而是用如下命令:

npm version [<newversion> | major | minor | patch | premajor | preminor | prepatch | prerelease | from-git]
  1. newversion: 直接给一个版本号;
  2. major: 主版本增加1;
  3. premajor: 预备主版本,主版本增加1,增加先行版本号;
  4. prelease: 预先发布版本,先行版本号增加1;

git 和 npm version 结合

手动更改版本号

执行 npm version <version> -m 'xx %s xx' 改变npm版本的同时,会执行一次 git commt -m 'xx %s xx'并用版本号打一个tag,%s 会替换成版本号,前提是版本库是干净的(clean)

自动更新版本

.git/hooks目录内,新建post-commit,输入以下内容:

#!/bin/sh
COMMIT_MSG="$(git log --pretty=format:"%s" -1 head)"
echo "$COMMIT_MSG" | grep  -q  "^[0-9]"
if [ $? -ne 0 ];then
   # 自动修改 patch
  echo $(npm version patch)
fi

在执行 git commit -m 'message'后,会检测message是否是版本号(y.x.z的形式),不是,则执行 npm version patch更新补丁版本,打一个tag。

如果想自动修改次版本,post-commit 的内容即可。

版本运算符

版本运算符指定了一定范围的版本。
主要有~^-<<=>>==版本运算符。

~ 版本号 ----- 指定主版本号或者次版本号相同

~ + 只含主版本 --- 主版本相同;
~ + 含有次版本 --- 主版本和次版本号相同。

版本范围匹配版本
~33.x 或者 3.0.0 <= v < 4.0.0
~3.13.1.x 或者 3.1.0 <= v <3.2.0
~3.1.23.1.2 < v < 3.2.0

指定的版本范围含有预发布版本,只会匹配和完整版本号相同的预发布版本。
~3.1.3-beta.2 匹配 3.1.3-beat.3 不匹配 3.1.4-beat-2

npm i lodash@~3 # 安装 3.10.1
npm i lodash@~3.9 # 安装 3.9.3
npm i lodash@~3.9.1 # 安装 3.9.3
npm i lodash@~3.8.0 # 安装 3.8.0

^ 版本号 --- 第一个非零 版本号相同

版本范围匹配版本补充
^3.1.53.1.5 <= v < 4.0.0
^0.3.60.3.6 <= v < 0.4.0
^0.0.20.0.2 <= v < 0.0.3
^3.x.x3.0.0 <= v < 4.0.0版本号缺少的位置,会被 0 填充
^4.2.x4.2.0 <= v < 4.3.0

npm 安装包时,默认使用 ^ 匹配版本。

安装主版本号为 3 的最新版本:

npm i lodash@^3 # 安装 3.10.1
npm i lodash@^3.9 # 安装 3.10.1
npm i lodash@^3.8.0 # 安装 3.10.1

~ vs ^

版本范围含义匹配的版本说明
~3.3.0与3.3.0相似3.3.0 <= v < 3.4.0主版本和次版本相同
^3.3.0与3.3.0兼容3.3.0 <= v < 4主版本相同

同一个版本号,^ 能匹配的范围大些,更加激进。

例子

npm i lodash@^3.3.0 # 安装 3.10.1
npm i lodash@~3.3.0 # 安装 3.3.1

~ 和 ≈ 差不多,可将 ~ 理解成相似,这样就分辨和理解了,~指定的是相似版本
^ 可理解成兼容版本

- 指定精确范围

版本范围匹配版本补充
2.0.0 - 3.2.72.0.0 <= v <= 3.2.7- 前后有空格
0.4 - 30.4.0 <= v <= 3.0.0缺少的版本号,被 0 填充
npm i vue@"1 - 1.9" # 安装 1.0.28

版本号比较器

版本范围匹配版本补充
<2.2.0小于2.2.0 的版本
<=2.0.0小于等于 2.0.0 的版本
\>4.2.0大于4.2.0 的版本
\>=4.2.0大于等于 4.2.0 的版本
=4.3.0等于 4.3.0 的版本

\ 是转义字符。

npm i lodash@\<3.5 # 安装 3.4.0
npm i lodash@\<=3.5 # 安装 3.5.0
npm i lodash@\>3.5 # 安装 4.17.11
npm i lodash@\>=3.5 # 安装 4.17.11
npm i vue@">1 <2.3" # 安装 2.2.6

分组 ||

或者的关系连接两个版本范围,极少使用。

npm i vue@"^0.7 || ~2" # 安装 2.6.10

参考

依赖的版本
版本号管理策略&&使用npm管理项目版本号
语义化版本2.0
whats-the-difference-between-tilde-and-caret-in-package-json

点赞
收藏
评论区
推荐文章
blmius blmius
4年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
冴羽 冴羽
3年前
聊聊 npm 的语义化版本(Semver)
前言现在我们要开发一个项目,我们都知道为了方便项目管理,要写一个版本号,那开发的时候初始的版本号是多少呢?是1.0.0还是0.0.1开始?如果一个版本号为X.Y.Z,什么时候是X应该加1,什么时候Y应该加1,什么时候Z应该加1,加1遵循十进制吗?比如1.0.9的下一个版本应该是1.1.0吗?我们经常看到一些项目的版
Wesley13 Wesley13
3年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
美凌格栋栋酱 美凌格栋栋酱
7个月前
Oracle 分组与拼接字符串同时使用
SELECTT.,ROWNUMIDFROM(SELECTT.EMPLID,T.NAME,T.BU,T.REALDEPART,T.FORMATDATE,SUM(T.S0)S0,MAX(UPDATETIME)CREATETIME,LISTAGG(TOCHAR(
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为
添砖java的啾 添砖java的啾
4年前
distinct效率更高还是group by效率更高?
目录00结论01distinct的使用02groupby的使用03distinct和groupby原理04推荐groupby的原因00结论先说大致的结论(完整结论在文末):在语义相同,有索引的情况下groupby和distinct都能使用索引,效率相同。在语义相同,无索引的情况下:distinct效率高于groupby。原因是di
Jacquelyn38 Jacquelyn38
4年前
2020年前端实用代码段,为你的工作保驾护航
有空的时候,自己总结了几个代码段,在开发中也经常使用,谢谢。1、使用解构获取json数据let jsonData  id: 1,status: "OK",data: 'a', 'b';let  id, status, data: number   jsonData;console.log(id, status, number )
Wesley13 Wesley13
3年前
VBox 启动虚拟机失败
在Vbox(5.0.8版本)启动Ubuntu的虚拟机时,遇到错误信息:NtCreateFile(\\Device\\VBoxDrvStub)failed:0xc000000034STATUS\_OBJECT\_NAME\_NOT\_FOUND(0retries) (rc101)Makesurethekern
Wesley13 Wesley13
3年前
mysql设置时区
mysql设置时区mysql\_query("SETtime\_zone'8:00'")ordie('时区设置失败,请联系管理员!');中国在东8区所以加8方法二:selectcount(user\_id)asdevice,CONVERT\_TZ(FROM\_UNIXTIME(reg\_time),'08:00','0
Stella981 Stella981
3年前
Django中Admin中的一些参数配置
设置在列表中显示的字段,id为django模型默认的主键list_display('id','name','sex','profession','email','qq','phone','status','create_time')设置在列表可编辑字段list_editable
Python进阶者 Python进阶者
1年前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这