首页·报错信息

npm · npm

报错原文

npm ERR! ERESOLVE unable to resolve dependency tree

这是什么意思

从 npm 7 起 peerDependencies 的版本范围会被强制执行,这句话是说 npm 找不到一组能同时满足所有范围的版本。常见于你要装的包的 peer 范围排除了你手上已有的 react 或 typescript 版本,尤其是刚做完一次大版本升级之后。读输出里的 Found: 和 Could not resolve: 两行,看清谁要求什么,然后把两者之一挪到兼容的版本——这才是真正的修法。npm install --legacy-peer-deps 会完全无视 peer 范围直接装上,能让你继续往下走,但留下的是一棵各个包从未认可的依赖树,版本不匹配带来的运行时错误得你自己去查。

怎么修

npm install --legacy-peer-deps
来自
npm
npm
20

npm 的原因写在第一行 code XXXX 里,而不是最后那六行 npm ERR!;如果失败来自依赖树或原生编译而不是你自己的代码,删掉 node_modules 重新安装就能解决一半。

怎么读报错

  • 从第一行往下读。越往下越是工具内部的事,起因通常写在最上面。
  • 有文件名和行号就从那里查——不是栈顶那一帧,而是最上面那条提到你自己写的文件的行。
  • 把报错原文照样去搜,但先去掉你自己的路径和变量名,正是那些让搜索匹配不上。
  • 同一种情况在不同版本里措辞不同。结果不对头,就把版本号一起加进查询。
  • 粘贴修法之前,先确认它会丢掉什么。这里面有些是不能撤回的。

常见问题

Q. “npm ERR! ERESOLVE unable to resolve dependency tree” 是什么意思?

从 npm 7 起 peerDependencies 的版本范围会被强制执行,这句话是说 npm 找不到一组能同时满足所有范围的版本。常见于你要装的包的 peer 范围排除了你手上已有的 react 或 typescript 版本,尤其是刚做完一次大版本升级之后。读输出里的 Found: 和 Could not resolve: 两行,看清谁要求什么,然后把两者之一挪到兼容的版本——这才是真正的修法。npm install --legacy-peer-deps 会完全无视 peer 范围直接装上,能让你继续往下走,但留下的是一棵各个包从未认可的依赖树,版本不匹配带来的运行时错误得你自己去查。

Q. 怎么修?

npm install --legacy-peer-deps —— 执行前先看上面的说明,确认这条命令会丢掉什么。

Q. 这是哪个工具报的?

npm。它属于npm,报错原文有 8 个词。

相关报错