package.json中^和~的含义
# 0.前言
本篇博客主要研究的是package.json中,对依赖的版本使用^和~的区别,主要有如下结论:
node_modules的version并不是瞎写的,需要遵循semver规范对version号进行命名。~1.2.3与^1.2.3的区别在于版本号取值范围~:限死在第2个小数点,即<1.3.0^:是最常用的配置,小于一个大版本,即<2.0.0(范围最大)
使用
package.lock.json时,无论是否加^/~都会锁死版本,当有大版本更新时,需要手动修改package.json。当
package.json与package.lock.json不一样时,以package.json为准,每次修改都会重新生成一份.lock.json文件。
# 1.semver规范
semver,Semantic Versioning 语义化版本的缩写,文档可见 https://semver.org/,它由 [major, minor, patch] 三部分组成,其中
major: 当你发了一个含有 Breaking Change 的 APIminor: 当你新增了一个向后兼容的功能时patch: 当你修复了一个向后兼容的 Bug 时
假设你的版本库中含有一个函数
// 假设原函数
export const sum = (x: number, y: number): number => x + y
// Patch Version,修复小 Bug
export const sum = (x: number, y: number): number => x + y
// Minor Version,向后兼容(支持更多的功能)
// 如:原先只支持两个数相加,现在接受多个数相加
export const sum = (...rest: number[]): number => rest.reduce((s, x) => s + x, 0)
// Marjor Version,出现 Breaking Change
export const sub = () => {}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
对于 ~1.2.3 而言,它的版本号范围是 >=1.2.3 <1.3.0
对于 ^1.2.3 而言,它的版本号范围是 >=1.2.3 <2.0.0
当我们 npm i 时,默认的版本号是 ^,可最大限度地在向后兼容与新特性之间做取舍,但是有些库有可能不遵循该规则,我们在项目时应当使用 yarn.lock/package-lock.json 锁定版本号。
# 2.package-lock工作流程
我们看看 package-lock 的工作流程。
npm i webpack,此时下载最新 webpack 版本5.58.2,在package.json中显示为webpack: ^5.58.2,版本号范围是>=5.58.2 < 6.0.0- 在
package-lock.json中全局搜索webpack,发现 webpack 的版本是被锁定的,也是说它是确定的webpack: 5.58.2 - 经过一个月后,webpack 最新版本为
5.100.0,但由于webpack版本在package-lock.json中锁死,每次上线时仍然下载5.58.2版本号 - 经过一年后,webpack 最新版本为
6.0.0,但由于webpack版本在package-lock.json中锁死,且package.json中webpack版本号为^5.58.2,与package-lock.json中为一致的版本范围。每次上线时仍然下载5.58.2版本号 - 支线剧情:经过一年后,webpack 最新版本为
6.0.0,需要进行升级,此时手动改写package.json中webpack版本号为^6.0.0,与package-lock.json中不是一致的版本范围。此时npm i将下载6.0.0最新版本号,并重写package-lock.json中锁定的版本号为6.0.0
编辑 (opens new window)
上次更新: 2022/10/08, 23:10:00