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 <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
版本号变动划定规矩
- 版本号只升不降,不得在数字前加0,比方 2.01.2 不允许的;
- 0.y.z,处于开辟阶段的版本;
- 第一个正式版版本每每命名为 1.0.0;
- 先行版本必需在补丁版本以后增添,比方 2.3.7-0,
0
示意先行版本,和补丁版本用-
分开; - 版本的比较顺次比较主版本→次版本→补丁版本→先行版本,直到第一个能得出比较效果为止;
- 不小心把一个不兼容的改版当成了次版本号刊行了该怎么办?一旦发明本身破坏了语义化版本掌握的范例,就要修改这个题目,并刊行一个新的次版本号来改正这个题目而且恢复向下兼容。即使是这类状况,也不能去修改已刊行的版本。
怎样处置惩罚行将弃用的功用?
弃用现存的功用是软件开辟中的粗茶淡饭,也平常是向前生长所必需的。但当你弃用大众API的一部份时,你应该做两件事:
(1)更新文档以便运用者晓得这个变化。
(2)刊行不包括弃用功用的次版本。在新主版本中完全移除弃用功用前,最少应有一个不包括弃用功用的次版本宣布,以便运用者可以腻滑过渡到新的API。
怎样更新版本号?不必手动修改 package.json。而是用以下敕令:
npm version [<newversion> | major | minor | patch | premajor | preminor | prepatch | prerelease | from-git]
- newversion: 直接给一个版本号;
- major: 主版本增添1;
- premajor: 准备主版本,主版本增添1,增添先行版本号;
- 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 的内容即可。
版本运算符
版本运算符指定了肯定局限的版本。
主要有~、^、–、<、<=、>、>=、=版本运算符。
~ 版本号 —– 指定主版本号或许次版本号雷同
~ + 只含主版本 — 主版本雷同;
~ + 含有次版本 — 主版本和次版本号雷同。
版本局限 | 婚配版本 |
---|---|
~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