npm安装puppeteer卡在reifyNode:node_modules/@types/node如何修复

该故障核心诱因是手动删除Node相关文件时，损坏了npm本地缓存、残留了失效的软链接/配置项，常规覆盖重装Node.js不会清理这部分残件，按以下顺序操作即可修复：

步骤1：彻底清理Node.js全量残留 #

• 先通过系统自带卸载功能移除当前已安装的Node.js：Windows在「应用和功能」中卸载，macOS将Node.js从应用目录移至废纸篓，Linux通过对应包管理器执行remove命令卸载
• 手动删除所有残留目录与文件，路径按系统区分：
  • Windows：删除C:\Program Files\nodejs、C:\Users\[你的当前用户名]\AppData\Roaming\npm、C:\Users\[你的当前用户名]\AppData\Roaming\npm-cache、C:\Users\[你的当前用户名]\.npm、C:\Users\[你的当前用户名]\AppData\Local\Temp下所有npm开头的临时文件夹
  • macOS/Linux：删除/usr/local/lib/node_modules、/usr/local/include/node、~/.npm、~/.npm-global、~/.cache/node，同时删除/usr/local/bin目录下所有node、npm、npx开头的软链接文件

步骤2：重装LTS版本Node.js #

安装Node.js官方长期支持版（别选最新测试版），安装完成后打开新的终端窗口，依次执行以下命令验证安装：

node -v
npm -v

两个命令都能正常输出版本号即为安装成功，如果提示命令不存在，说明残留未清理干净或者环境变量配置错误，回到步骤1重新检查。

步骤3：重置npm缓存 #

reify环节卡住90%以上是本地缓存存在损坏文件导致的，执行强制清理命令：

npm cache clean --force

清理完成后执行npm cache verify，返回缓存校验通过、无报错即可进入下一步。

步骤4：安装puppeteer #

puppeteer安装时默认会下载Chromium二进制文件，国内网络环境下容易出现下载卡顿，提前配置国内镜像后再安装：

• 临时单次安装直接执行带参数命令：

npm install puppeteer --registry=https://registry.npmmirror.com --puppeteer_download_host=https://npmmirror.com/mirrors

• 如果需要长期使用，提前把镜像配置写入npm全局设置：

npm config set registry https://registry.npmmirror.com
npm config set puppeteer_download_host https://npmmirror.com/mirrors

如果是在已有项目中安装，先删除项目目录下的node_modules文件夹和package-lock.json文件，再执行安装命令即可。

注意：后续卸载Node相关程序不要手动删除系统lib目录下的文件，这类手动操作很容易残留失效配置、损坏的缓存文件、断链软链接，直接导致软件包管理器工作异常，优先使用官方卸载程序或系统包管理器完成卸载操作。

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