安装Puppeteer失败：提示找不到progress模块，求解决方案

错误核心 #

安装Puppeteer时触发MODULE_NOT_FOUND错误，提示找不到progress模块的index.js文件，本质是依赖包progress未正确安装或损坏。

已尝试操作 #

• 已安装Chromium和puppeteer-core
• Node.js版本v20.4.0，npm版本9.8.1
• 已删除node_modules和package-lock.json

具体解决步骤 #

1. 清理npm缓存 #

执行命令彻底清理npm缓存，避免缓存的损坏依赖影响安装：

npm cache clean --force

2. 单独安装progress依赖 #

手动安装缺失的progress模块，确保其完整：

npm install progress

3. 重新安装Puppeteer #

完成上述操作后，重新安装Puppeteer：

npm install puppeteer

4. （可选）使用yarn替代npm安装 #

如果npm仍有问题，尝试用yarn安装，依赖管理更稳定：

# 先安装yarn（如果未安装）
npm install -g yarn
# 清理现有依赖后用yarn安装
yarn install

5. 检查路径问题 #

你的项目路径包含空格（C:\SC by IchanZX V3），部分Node.js包对含空格的路径兼容性不佳，建议将项目移到无空格的路径下（比如C:\SC-IchanZX-V3）后再重试安装。

报错信息原文 #

npm ERR! code 1
npm ERR! path C:\SC by IchanZX V3\node_modules\puppeteer
npm ERR! command failed
npm ERR! command C:\WINDOWS\system32\cmd.exe /d /s /c node install.js
npm ERR! node:internal/modules/cjs/loader:415
npm ERR!       const err = new Error(
npm ERR!                   ^
npm ERR!
npm ERR! Error: Cannot find module 'C:\SC by IchanZX V3\node_modules\progress\index.js'. Please verify that the package.json has a valid "main" entry
npm ERR!     at tryPackage (node:internal/modules/cjs/loader:415:19)
npm ERR!     at Module._findPath (node:internal/modules/cjs/loader:665:18)
npm ERR!     at Module._resolveFilename (node:internal/modules/cjs/loader:1034:27)
npm ERR!     at Module._load (node:internal/modules/cjs/loader:901:27)
npm ERR!     at Module.require (node:internal/modules/cjs/loader:1115:19)
npm ERR!     at require (node:internal/modules/helpers:119:18)
npm ERR!     at Object.<anonymous> (C:\SC by IchanZX V3\node_modules\puppeteer\lib\cjs\puppeteer\node\install.js:24:36)
npm ERR!     at Module._compile (node:internal/modules/cjs/loader:1233:14)
npm ERR!     at Module._extensions..js (node:internal/modules/cjs/loader:1287:10)
npm ERR!     at Module.load (node:internal/modules/cjs/loader:1091:32) {
npm ERR!   code: 'MODULE_NOT_FOUND',
npm ERR!   path: 'C:\\SC by IchanZX V3\\node_modules\\progress\\package.json',
npm ERR!   requestPath: 'progress'
npm ERR! }
npm ERR!
npm ERR! Node.js v20.4.0

npm ERR! A complete log of this run can be found in: C:\Users\Ravabox\AppData\Local\npm-cache\_logs\2023-08-12T10_31_57_338Z-debug-0.log

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