Windows11下npm安装whatsapp-web.js卡在puppeteer postinstall阶段

• 跳过Chromium下载：puppeteer默认会自动下载Chromium，国内网络环境下大概率是卡在这一步。可以通过环境变量跳过下载，前提是你的系统已经安装了Chrome浏览器：
  执行安装前先设置环境变量：

  set PUPPETEER_SKIP_DOWNLOAD=true
  

  或者直接在安装命令中附加参数：

  npm install github:pedroslopez/whatsapp-web.js#webpack-exodus --verbose --PUPPETEER_SKIP_DOWNLOAD=true
  

• 配置国内镜像加速下载：如果不想跳过下载，给puppeteer设置国内镜像源，避免下载超时：

  set PUPPETEER_DOWNLOAD_HOST=https://npm.taobao.org/mirrors
  

  再执行原安装命令即可。

• 检查权限问题：Windows下若无管理员权限，可能导致文件写入失败进而卡住。右键终端选择「以管理员身份运行」，再重新执行安装命令。

• 清理缓存后重试：残留的缓存文件可能损坏，先清理npm缓存：

  npm cache clean --force
  

  然后删除项目目录下的node_modules文件夹和package-lock.json文件，再重新执行安装。

• 验证Node.js版本兼容性：puppeteer@18.2.1要求Node.js版本≥16.13.0，用node -v查看当前版本，版本过低会导致安装脚本执行异常。

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