安装项目时遇loader-utils@undefined版本匹配失败问题求助

我之前也碰到过一模一样的报错，这种情况基本都是项目依赖链里有某个包错误地请求了loader-utils的undefined版本，导致npm找不到匹配的包。给你几个亲测有效的解决办法：

• 先清理npm缓存：缓存里的旧数据有时候会干扰依赖解析，先执行这个命令重置缓存：

  npm cache clean --force
  

  要是用的是较新版本的npm，也可以用更安全的缓存验证命令：

  npm cache verify
  

• 删除旧依赖文件重新安装：把项目里的node_modules文件夹和包锁文件删掉，让npm重新拉取所有依赖的正确版本：

  rm -rf node_modules package-lock.json
  npm install
  

  这样能彻底清除旧锁文件里可能存在的错误版本引用，大概率能解决问题。

• 定位到底是哪个包搞的鬼：如果上面的方法没用，就用npm的依赖树命令找出请求错误版本的源头：

  npm ls loader-utils
  

  这个命令会输出所有依赖loader-utils的包，你能看到哪个包后面跟着undefined版本。找到之后，要么把这个包升级到修复了该问题的版本，要么直接在你的package.json里明确指定loader-utils的稳定版本（比如^1.4.0或者最新的兼容版本），强制npm使用正确版本。

• 试试切换npm版本：有时候npm本身的版本bug也会导致依赖解析异常，你可以切换到一个稳定的版本再试：

  npm install -g npm@6  # 这里可以换成你需要的稳定版本号
  

我当时是项目里一个旧版本的html-webpack-plugin导致的这个问题，把它升级到最新兼容版本后就顺利安装了。如果你的日志里有更多具体的依赖路径信息，直接针对那个包处理会更高效。

内容的提问来源于stack exchange，提问作者Nathan Hyland