更新Node.js后执行npm install命令失败如何解决？

问题根因及解决步骤 #

• 依赖版本与Node版本不兼容
  包含原生编译逻辑的第三方依赖包通常会绑定适配特定Node.js版本范围，你可以先查看项目package.json中的engines字段，确认项目要求的Node版本区间。如果存在版本限制，可通过nvm切换到对应Node版本执行安装，也可以将对应依赖包升级到适配当前Node版本的发布版。
• npm缓存损坏
  旧版本Node生成的npm缓存会与新版本产生冲突，执行缓存清理命令后重试即可：

  npm cache clean --force
  

• 旧锁文件与旧依赖残留冲突
  之前版本运行时生成的package-lock.json、node_modules文件夹中的依赖适配旧Node版本，直接删除后重新执行安装即可：

  # Windows 环境可通过资源管理器手动删除对应文件/文件夹
  rm -rf node_modules package-lock.json
  npm install
  

• npm版本与Node版本不匹配
  每一个Node版本都有官方推荐的对应npm版本，你可以执行npm -v查看当前npm版本，和Node官方文档中对应Node版本绑定的npm版本做比对，不符合的话执行命令升级到对应版本即可：

  npm install -g npm@匹配的版本号
  

• 原生模块编译环境缺失
  包含C/C++源码的依赖包安装时需要本地编译环境，Windows环境需要提前安装windows-build-tools，Mac环境需要安装Xcode命令行工具，Linux环境需要安装gcc、make等编译组件：

  # Windows 环境执行
  npm install -g windows-build-tools
  # Mac 环境执行
  xcode-select --install
  # Debian/Ubuntu 系Linux执行
  sudo apt install build-essential
  

• *nix环境全局安装权限不足
  Mac/Linux环境下npm默认全局安装路径需要管理员权限，你可以修改npm全局路径到用户目录下规避权限问题：

  npm config set prefix ~/.npm-global
  echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
  source ~/.bashrc
  

内容的提问来源于stack exchange，提问作者Umidjon Tojiboyev