yarn or npm 版本固化如何选择
前言
作为前端开发者,npm这个包管理工具的重要性显而易见。优点不再表述,但一些缺点是为使用者诟病比较多的:速度慢、版本控制。下面主要讨论下npm的版本固化问题,即lock文件。
npm语义化版本管理
对于npm来说,依赖相关的信息体现在package.json的dependencies里,这里使用了Semver(语义化版本来控制)关于语义化版本的规范可以查看。
大致准则如下:
- 软件的版本通常由三位组成,形如:X.Y.Z
- 版本是严格递增的,此处是:16.2.0 -> 16.3.0 -> 16.3.1
- 在发布重要版本时,可以发布alpha, rc等先行版本
- alpha和rc等修饰版本的关键字后面可以带上次数和meta信息
版本格式:
发布者应该关注的是版本格式的规则
主版本号.次版本号.修订号
不同版本号递增规则如下:
- 主版本号(major):当你做了不兼容的 API 修改,
- 次版本号(minor):当你做了向下兼容的功能性新增,可以理解为Feature版本,
- 修订号(patch):当你做了向下兼容的问题修正,可以理解为Bug fix版本。
package.json里面的依赖版本要求遵循上述规则的。
这样才能保证使用者引到期望的版本。
版本控制符
对于使用者来说,版本前面的控制符是需要关注的,这决定引用依赖是否与期望相同。
npm 支持的符号是比较丰富的,下面的版本符号均支持:
{ "dependencies" :
{ "foo" : "1.0.0 - 2.9999.9999",// 大于等于1.0.0 小于 2.9999.9999
"bar" : ">=1.0.2 <2.1.2", // 比较清晰 左闭右开
"baz" : ">1.0.2 <=2.3.4", // 左开右闭
"boo" : "2.0.1", // 规定版本
"qux" : "<1.0.0 || >=2.3.1 <2.4.5 || >=2.5.2 <3.0.0", // 表达式也算清晰
"asd" : "http://asdf.com/asdf.tar.gz"// 指定下载地址代替版本
, "til" : "^1.2.3"// 同一主版本号,不小于1.2.3 即 1.x.y x>=2 y>=3
, "elf" : "~1.2.3" // 同一主版本和次版本号 即1.2.x x>= 2
, "two" : "2.x" // 这个比较形象,x>=0 即2.0.0 以上均可
, "thr" : "3.3.x" // 同上 x>= 0 即3.3.0 以上
, "lat" : "latest" // 最新版本
, "dyl" : "file:../dyl" // 从本地下载
}
}
根据上面的注释,应该能看清不同符号的意思了。这里有一篇文章比较生动的阐述了不同符号的范围,有兴趣可以详细看下
npm install 默认使用^
这样的目的在于接受指定版本的更新,例如依赖包的优化和小版本更新。
问题
不同环境依赖不一致
从上面可以看到,语义化版本是没有强制约束的,需要开发者自觉遵守规范定义。
常见情况如下:
测试环境完成之后上线出问题,细究原因在于上线前某个依赖版发布了不兼容或者有bug 版本,恰好在发布时装了新版本。
所以才会有下面固化版本即锁版本需求的出现。
固化版本,保证不同环境或者时间安装的都是相同依赖。至于是否都应该固化版本,下面再讨论。
固化版本方式
固话版本,有下面三种方式:
npm-shrinkwrap.json
该方式是比较早的锁定版本的方式,
与package-lock.json功能类似,区别在于npm包发布的时候可以发布上去。
推荐的使用情况是,通过仓库上的发布过程来部署的应用,即非库或者工具类。
例如:emons和命令行工具,想要被全局安装或者依赖,此时强烈不建议坐着发布该文件,因为将会阻止终端用户控制传递依赖的更新。
另外如果package-lock.json和npm-shrinkwrap.json同时存在于项目根目录,package-lock.json将会被忽略。
即该方式会将锁版本依赖通过npm发布,所以类库或者组件需要慎重。
使用方式:
// 生成依赖 默认不包括dev dependencies
npm shrinkwrap
// 将dev-dependencies计算在内
npm shrinkwrap--dev
package-lock.json
相对于npm-shrinkwrap ,其不会被发布到npm,适用于应用程序,即我们非工具类的项目。
npm5 以后 依赖都会默认增加该文件,不过迭代了这么多版本,不同版本npm对package-lock.json的实现是不同的。是在一直迭代和发展的
1、npm 5.0.x 版本,
不管package.json怎么变,npm i 时都会根据lock文件下载。
2、5.1.0版本后
npm install 会无视lock文件 去下载最新的npm包
3、5.4.2版本
如果改了package.json,且package.json和lock文件不同,那么执行npm i
时npm会根据package中的版本号以及语义含义去下载最新的包,并更新至lock。
如果两者是同一状态,那么执行npm i
都会根据lock下载,不会理会package实际包的版本是否有新。
该段内容参考自知乎用户,详情请转https://www.zhihu.com/question/264560841
这样带来一个问题,不同环境不同npm版本,对于同一项目,依赖还是可能不同的。。。。
非扁平依赖
对于同一npm包不同版本的管理,npmlock是非完全扁平化的处理:
所有的包的依赖顺序列出来,第一次出现的包名会提升到顶层,后面重复出现的将会放入被依赖包的node_modules当中
例如下面这个例子:
第一个依赖,提升为顶层依赖
// 顶层声明了loader-utils的依赖,版本为1.0.4
"loader-utils": {
"version": "1.0.4",
"resolved": "http://r.npm.sankuai.com/loader-utils/download/loader-utils-1.0.4.tgz",
"integrity": "sha1-E/Vhl/FSOjBYkSSLTHJEVAhIQmw=",
"requires": {
"big.js": "^3.1.3",
"emojis-list": "^2.0.0",
"json5": "^0.5.0"
}
}
}
对于顶级依赖满足需求的,则不再安装、
"sass-loader": {
"version": "7.1.0",
"resolved": "http://r.npm.sankuai.com/sass-loader/download/sass-loader-7.1.0.tgz",
"integrity": "sha1-Fv1ROMuLQkv4p1lSihly1yqtBp0=",
"dev": true,
"requires": {
// ^1.0.1 顶级依赖满足需求
"loader-utils": "^1.0.1"
}
}
对于某些依赖不满足的,则会在对应文件夹下面根据依赖安装符合版本。例如less-loader
"less-loader": {
"version": "4.1.0",
"resolved": "http://r.npm.sankuai.com/less-loader/download/less-loader-4.1.0.tgz",
"requires": {
// 1.0.4 不满足 ^1.1.0
"loader-utils": "^1.1.0",
},
"dependencies": {
"loader-utils": {
"version": "1.2.3",
"resolved": "http://r.npm.sankuai.com/loader-utils/download/loader-utils-1.2.3.tgz",
"integrity": "sha1-H/XcaRHJ8KBiUxpMBLYJQGEIwsc=",
"dev": true,
"requires": {
"big.js": "^5.2.2",
"emojis-list": "^2.0.0",
"json5": "^1.0.1"
}
}
}
}
package-lock.json和npm-shrinkwrap.json差别
- package-lock.json不会被发布到npm,而npm-shrinkwrap会被默认发布
- 非顶层的package-lock.json会被忽略,而相同状态的shrinkwrap文件都会被保留。
- npm-shrinkwrap.json在npm 2,3,4版本均支持,package-lock.json是npm5以后引入
- 两者同时存在,npm-shrinkwrap.json的优先级高于package-lock.json
yarn.lcok
yarn毕竟是针对npm的缺点而生,所以其自带版本控制,默认依赖都会生成yarn.lock文件,该文件会通过包名+版本来确定具体信息。
yarn-lock语法
Yarn 用的是自己设计的格式,语法上有点像 YAML(Yarn 2.0 中将会采用标准的 YAML)。# 开头的行是注释。
第一行记录了包的名称及其语义化版本(由 package.json 定义)。
接下来的都做了缩进,表示这些是该包的信息。
version 字段记录了包的确切版本。
resolved 字段记录了包的 URL。此外,hash 中的值是 shasum。Yarn 记录的这个 shasum 来自于包的 versions[:version].dist.shasum(手动访问 https://registry.npmjs.org/:package 会得到一个 JSON,解析此 JSON 可得)
dependencies 记录了包的依赖。也许包的依赖还有依赖,但不会在这里记录。
如下所示:
pkg-dir@^1.0.0:
version "1.0.0"
resolved "http://r.npm.sankuai.com/pkg-dir/download/pkg-dir-1.0.0.tgz#7a4b508a8d5bb2d629d447056ff4e9c9314cf3d4"
integrity sha1-ektQio1bstYp1EcFb/TpyTFM89Q=
dependencies:
find-up "^1.0.0"
pkg-dir@^2.0.0:
version "2.0.0"
resolved "http://r.npm.sankuai.com/pkg-dir/download/pkg-dir-2.0.0.tgz#f6d5d1109e19d63edf428e0bd57e12777615334b"
integrity sha1-9tXREJ4Z1j7fQo4L1X4Sd3YVM0s=
dependencies:
find-up "^2.1.0"
pkg-dir@^3.0.0:
version "3.0.0"
resolved "http://r.npm.sankuai.com/pkg-dir/download/pkg-dir-3.0.0.tgz#2749020f239ed990881b1f71210d51eb6523bea3"
integrity sha1-J0kCDyOe2ZCIGx9xIQ1R62UjvqM=
dependencies:
find-up "^3.0.0"
不过Yarn 仅以 flatten 格式 描述各个包之间的依赖关系,并依赖于其当前实现来创建目录结构。这意味着如果其内部算法发生变化,结构也会发生变化。
提升
你会发现,有很多包你是没有直接依赖它们的,但它们都出现在了 yarn.lock 中的顶层。这就是提升,它有两个意义:
-
记录依赖的依赖
正如上面所述,依赖的依赖不会被直接记录在依赖的信息下——它们会被提升,这样可以简化整个 yarn.lock,到时安装依赖的时候处理也变得简单,因为你不必一层一层的嵌套下去来查找依赖的依赖的信息。 -
便于解决依赖版本冲突
依赖版本冲突是难免的,当然有时候并不是版本冲突,而只是语义化版本格式的版本记录不同。举个例子,^5.0.0 与 5.x.x 在很多时候并不矛盾,因此信息可以被合并。如:
chalk@^2.0.0, chalk@^2.0.1:
version "2.3.2"
resolved "https://registry.yarnpkg.com/chalk/-/chalk-2.3.2.tgz#250dc96b07491bfd601e648d66ddf5f60c7a5c65"
dependencies:
ansi-styles "^3.2.1"
escape-string-regexp "^1.0.5"
supports-color "^5.3.0"
注意第一行,yarn.lock 记录了 ^2.0.0 和 ^2.0.1,而在添加 chalk 这个依赖的时候,符合语义化版本的最新版本是 2.3.2(version 字段),这个版本对于 ^2.0.0 和 ^2.0.1 这两个要求来说,都满足了,因此信息可以合并。
对于固化还是建议使用yran.lock实现,npm的lock在不同版本下存在的差异让人头疼。
是否应锁版本
这个争论是很正常的,开始使用时,我们也有过这样的讨论。
大家可以看下我们的场景再讨论:
1、组内项目都依赖了自己开发的一个工具包a
2、该工具类依赖了一些第三方开源包
场景一:
当时某个知名包升级之后移除了某项功能的支持,被a依赖,导致该段时间后上线的项目全都出了问题。
场景二:
a发现出了个bug,统一修复,各个业务项目无需自行修改。
结合来看还是要具体分析,对于自行维护或者确认无误的项目可以不锁版本。对于第三方需要锁版本,保证当前是可用的。对于后期的bug修复,不自行升级,对于bugfix等小版本升级,验证完成后再次锁版本。
.gitignore是否应该忽略lock文件
对于 是否应该package-lock.json 不应写进 .gitignore,可以看下贺师俊大佬的解释:
如果你使用 lock 机制,则应该将 package-lock.json 提交到 repo 中。比如 Vue 采取了该策略。如果你不使用 lock 机制,则应该加入 .npmrc 文件,内容为 package-lock=false ,并提交到 repo 中。比如 ESLint 采取了该策略。
还是回到了那个问题,是否应该锁版本。
对于类库而言,锁定依赖版本是 绝对不可行 的。否则只要应用中使用了两个以上的依赖,都有概率出现绝对不存在可兼容版本的情况。这样只是单纯的把问题抛给了最终应用,并没有解决问题。
最终应用是否锁也有待考虑。
问题出在源码的可靠性不得到保证,本身语义化没有问题。但是又bug正常,所以业务项目才锁
结束语
参考文章
https://docs.npmjs.com/files/package.json
https://juejin.im/post/5ad413ba6fb9a028b5485866#heading-1
https://stackoverflow.com/questions/44258235/what-is-the-difference-between-npm-shrinkwrap-json-and-package-lock-json
针对是否应该固化版本和如何固化版本,因为水平有限也只是给出了自己的一点看法。希望能对有需要的同学有所帮助。