快速解决NPM报错:peerDependencies WARNING

问题背景

今天遇到一个问题:安装Webpack 3.x之后其它包提示peerDependencies WARNING,意思是包版本不兼容。

【难题】虽然NPM已经很自动化了,但依赖问题真的是一个难题,无法自动解决,需要人工干预调整。StackOverflow上的这篇问答也说了该问题无法自动处理。

【解决办法】去查各个版本的依赖关系,人工调整版本号。每个包的依赖关系都是放在package.json里面的,一个个版本去看当然很麻烦,这里介绍一个小技巧。

问题重现

例如我们现在安装了Webpack 3,package.json如下:

{
  "devDependencies": {
    "webpack": "^3.0.0",
  }
}

但是安装npm install --save-dev sass-loader的时候报错了,
错误比较明确说了sass-loader需要依赖新版的webpack,但是安装的webpack偏旧:

peerDependencies WARNING sass-loader@^8.0.0 requires a peer of webpack@^4.36.0 but webpack@3.12.0 was installed

解决步骤

现在我们需求明确要用Webpack 3,那只能让sass-loader降级了,问题是降到哪个版本呢?这里我们通过npm view命令来帮助我们寻找合适的版本。

  1. 首先敲npm view sass-loader versions,这会告诉我们sass-loader一共有哪些版本:
$ cnpm view sass-loader versions
[
  '0.0.1', '0.0.2', '0.1.0', '0.1.1',
  '0.2.0', '0.3.0', '0.3.1', '0.4.0-beta.1',
   ...
  '7.2.0', '7.3.0', '7.3.1', '8.0.0'
]
  1. 然后我们敲npm view sass-loader@8.0.0 peerDependencies,可以看到果然sass-loader 8.0.0依赖了webpack 4.36.0:
$ npm view sass-loader@8.0.0 peerDependencies
{
  webpack: '^4.36.0',
  'node-sass': '^4.0.0',
  sass: '^1.3.0',
  fibers: '>= 3.1.0'
}
  1. 为了找到能用的旧版,我们只能一个个版本检查,例如我们看看sass-loader 7.3.1能不能用:
$ cnpm view sass-loader@7.3.1 peerDependencies
{ webpack: '^3.0.0 || ^4.0.0' }
  1. 可以看到sass-loader 7.3.1是能兼容webpack 3.x的,那么我们就找到了,然后我们可以修改package.json,将兼容的版本填入:
{
  "devDependencies": {
    "sass-loader": "^7.3.1",
    "webpack": "^3.0.0"
  }
}

总结

当遇到版本依赖问题时,只能人工处理。

可以利用npm view <pkgname> [field]快速查看package.json的某个字段,也可以加上版本号使用npm view <pkgname>@version,如果不知道一共有哪些历史版本可以敲npm view <pkgname> versions。npm view的用法见官网文档

人工寻找版本是不可避免的,为了提升效率可以:

  • 结合二分法快速缩小范围
  • 然后嫌国内网速慢可以用cnpm替代npm
  • 版本号可以指定一个范围,例如:npm view bootstrap@^4.0.0
©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • 非常感谢胖哥的博客和掘金小册的技术分享,希望大家去下面的链接去查看原文,他们写的非常好,都是多个项目经验的总结!!...
    示十阅读 2,286评论 0 2
  • 在现在的前端开发中,前后端分离、模块化开发、版本控制、文件合并与压缩、mock数据等等一些原本后端的思想开始...
    Charlot阅读 5,480评论 1 32
  • 全局安装webpack 全局安装webpack会有个问题,就是当你有两个项目依赖于不同版本的webpack,就会有...
    説好的妹紙呢阅读 1,852评论 0 11
  • 前端开发规范-react/react-router/redux/webpack/es6开发配置 项目地址: htt...
    燕京博士阅读 2,090评论 0 1
  • 不知道你有没有早恋过,但早恋的人一定知道那种幸福地感觉,比之后所有的幸福都来得踏实。 之前跟同学探讨过该不...
    女王英伦FAN阅读 228评论 0 0