资讯专栏INFORMATION COLUMN

npm 语义化版本控制

dongfangyiyu / 1700人阅读

摘要:版本控制为了在软件版本号中包含更多意义,反映代码所做的修改,产生了语义化版本,软件的使用者能从版本号中推测软件做的修改。的版本号由三部分组成主版本号次版本号补丁版本号。安装参考依赖的版本版本号管理策略使用管理项目版本号语义化版本

NPM 版本控制

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

主版本号(major):软件做了不兼容的变更(breaking change 重大变更);

次版本号(minor):添加功能或者废弃功能,向下兼容;

补丁版本号(patch):bug 修复,向下兼容。

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

常见的标签有 :

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

更多关于标签的内容

查看标签:

npm dist-tags ls 
npm dist-tags ls vue

得到:

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

安装带标签的版本

npm i @
npm i vue@beta # 安装 2.6.0-beta.3
版本号变更规则

版本号只升不降,不得在数字前加0,比如 2.01.2 不允许的;

0.y.z,处于开发阶段的版本;

第一个正式版版本往往命名为 1.0.0;

先行版本必须在补丁版本之后添加,比如 2.3.7-0,0表示先行版本,和补丁版本用-分隔;

版本的比较依次比较主版本次版本补丁版本先行版本,直到第一个能得出比较结果为止;

不小心把一个不兼容的改版当成了次版本号发行了该怎么办?一旦发现自己破坏了语义化版本控制的规范,就要修正这个问题,并发行一个新的次版本号来更正这个问题并且恢复向下兼容。即使是这种情况,也不能去修改已发行的版本。

NPM版本计算器

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

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

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

npm version [ | major | minor | patch | premajor | preminor | prepatch | prerelease | from-git]

newversion: 直接给一个版本号;

major: 主版本增加1;

premajor: 预备主版本,主版本增加1,增加先行版本号;

prelease: 预先发布版本,先行版本号增加1;

git 和 npm version 结合 手动更改版本号

执行 npm 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 的内容即可。

版本运算符

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

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

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

版本范围 匹配版本
~3 3.x 或者 3.0.0 <= v < 4.0.0
~3.1 3.1.x 或者 3.1.0 <= v <3.2.0
~3.1.2 3.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.5 3.1.5 <= v < 4.0.0
^0.3.6 0.3.6 <= v < 0.4.0
^0.0.2 0.0.2 <= v < 0.0.3
^3.x.x 3.0.0 <= v < 4.0.0 版本号缺少的位置,会被 0 填充
^4.2.x 4.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.7 2.0.0 <= v <= 3.2.7 - 前后有空格
0.4 - 3 0.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

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/109246.html

相关文章

  • NPM酷库:semver 语义版本判断

    摘要:今天在此向大家推荐一种非常流行的版本号命名规则语义化版本。语义化版本约定修订版本号代表在和之前接口不变的前提下修正了。就是专门用于语义化版本号检查的库,其也是语义化版本标准的制定者。 NPM酷库,每天两分钟,了解一个流行NPM库。 软件的命运就是不断维护、更新、迭代,所以我们用版本号来区分一个软件的不同时期和形态,版本号的命名方式有各种各样,有的以小数表示(几点几),有的以日期表示,有...

    Carbs 评论0 收藏0
  • [译]Yarn:一个新的JavaScript包管理器

    摘要:第一个主要的包管理器在被引用后不久就搭建起来了,并且迅速成为世界上最受欢迎的包管理器之一。简介是一款新的包管理器,在取代客户端和其他包管理器现有工作流的同时,又保留了对代理的兼容性。 在JavaScript社区,工程师们分享了成百上千的代码段,我们不用自己从头编写基础组件、类库或者框架。反过来,每段代码又或许依赖于其它的代码段,而这些依赖就是通过 package managers(包管...

    Steve_Wang_ 评论0 收藏0
  • pkg版本规范管理自动最佳实践

    摘要:为什么为什么不是为什么不是为什么不是为什么不是严格的指导原则有助于为版本号提供意义。此外,如果你有打破当前的,这同样表示你需要升级你的主版本号了。 前提 何为版本?版本即语义版本控制( Semantic version 后面简称为 SemVer )是一种版本控制系统,在过去几年中一直在不断发展。 随着每天都在构建新的插件,插件,扩展和库,拥有通用的软件开发项目版本化方法是一件好事,可以...

    Ocean 评论0 收藏0
  • 前端核心工具:yarn、npm、cnpm三者如何优雅的在一起使用 ?

    摘要:由于文件中版本号的特点,下面三个版本号在安装的时候代表不同的含义。安装版本统一为了防止拉取到不同的版本,有一个锁定文件记录了被确切安装上的模块的版本号。 showImg(https://segmentfault.com/img/bVbs8Rg?w=1920&h=1080); 一位用不好包管理器的前端,是一个入门级前端,一个用不好webpack的前端,是一个初级前端 三个包管理器是可以一...

    sihai 评论0 收藏0
  • 前端核心工具:yarn、npm、cnpm三者如何优雅的在一起使用 ?

    摘要:由于文件中版本号的特点,下面三个版本号在安装的时候代表不同的含义。安装版本统一为了防止拉取到不同的版本,有一个锁定文件记录了被确切安装上的模块的版本号。 showImg(https://segmentfault.com/img/bVbs8Rg?w=1920&h=1080); 一位用不好包管理器的前端,是一个入门级前端,一个用不好webpack的前端,是一个初级前端 三个包管理器是可以一...

    plus2047 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<