Netlify部署React网站时出现NPM install报错如何修复

按以下优先级逐一排查，绝大多数同类问题都能解决：

• 先做完全清理再重装依赖，直接重复执行npm install没有意义，锁文件和缓存冲突是最高发的原因：
  依次执行以下命令：

  # 删除已安装的依赖目录
  rm -rf node_modules
  # 删除所有包管理器对应的锁文件
  rm -f package-lock.json yarn.lock pnpm-lock.yaml
  # 强制清空npm本地缓存
  npm cache clean --force
  # 重新执行依赖安装
  npm install
  

• 确认本地开发和部署平台的Node.js版本一致：绝大多数部署平台默认Node版本和本地开发版本不匹配时，会出现原生依赖编译失败、ES语法不兼容等问题。在项目根目录新建.nvmrc文件，写入你本地开发用的Node大版本号（比如本地用18.x就写18），同时在部署平台的环境配置里把Node版本指定为相同值。
• 检查package.json里的依赖配置：
  • 不要写file:../xxx这类本地路径引用的依赖，部署环境拉不到你本地的文件会直接报错
  • 如果用到了私有源的依赖包，要提前在部署平台配置对应私有源的访问凭证，不要默认走公共npm源拉取
  • 不要把需要全局安装的包写到项目依赖里，部署环境默认的权限限制大概率会导致全局安装失败，所有项目运行需要的包都要装到本地dependencies或devDependencies中
• 如果报错日志里出现node-gyp相关的编译报错，是系统缺少基础编译工具导致的：Linux类部署环境先执行apt-get update && apt-get install -y build-essential python3安装编译依赖，再执行npm install；Windows部署环境提前安装windows-build-tools即可。
• 如果以上操作都没解决，开调试日志定位具体出错的包：执行npm install --loglevel=debug，最外层的"Error during NPM install"只是通用提示，具体根因在日志末尾的具体包报错信息里，定位到单个包之后再针对性查对应包的版本兼容问题即可。

小提示：如果用的是Vercel、Netlify这类第三方托管平台，不要在项目根目录随便写自定义的.npmrc配置，尤其是设置engine-strict=true这类强校验规则，很容易因为版本校验不通过直接阻断安装流程。

内容的提问来源于stack exchange，提问作者Developer Awdhesh