执行npm install遇多类错误（含node-gyp、better-sqlite3问题）求解决

报错详情 #

C:\Users\Administrator\Desktop\Multiguild-Modmail-main>npm install
npm 警告 已弃用 @discordjs/collection@0.7.0: 不再支持
npm 警告 已弃用 @discordjs/builders@0.16.0: 不再支持
npm 错误 代码 1
npm 错误 路径 C:\Users\Administrator\Desktop\Multiguild-Modmail-main\node_modules\better-sqlite3
npm 错误 命令执行失败
npm 错误 命令 C:\Windows\system32\cmd.exe /d /s /c prebuild-install || node-gyp rebuild --release
npm 错误 prebuild-install 警告 安装 未找到预构建二进制文件 (target=22.9.0 runtime=node arch=x64 libc= platform=win32)
npm 错误 node:internal/modules/cjs/loader:1251
npm 错误   throw err;
npm 错误   ^
npm 错误
npm 错误 错误: 无法找到模块 'C:\Users\Administrator\Desktop\Multiguild-Modmail-main\node_modules\node-gyp\bin\node-gyp.js'
npm 错误     在 Module._resolveFilename (node:internal/modules/cjs/loader:1248:15)
npm 错误     在 Module._load (node:internal/modules/cjs/loader:1074:27)
npm 错误     在 TracingChannel.traceSync (node:diagnostics_channel:315:14)
npm 错误     在 wrapModuleLoad (node:internal/modules/cjs/loader:217:24)
npm 错误     在 Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:166:5)
npm 错误     在 node:internal/main/run_main_module:30:49 {
npm 错误   code: 'MODULE_NOT_FOUND',
npm 错误   requireStack: []
npm 错误 }
npm 错误
npm 错误 Node.js v22.9.0
npm 错误 本次运行的完整日志可在以下路径查看: C:\Users\Administrator\AppData\Local\npm-cache_logs\2024-10-14T11_09_44_527Z-debug-0.log

解决步骤 #

1. 全局安装 node-gyp 及依赖工具 #

node-gyp 缺失是核心报错原因，需先全局安装并配置依赖：

• 全局安装 node-gyp：

  npm install -g node-gyp
  

• 安装 Windows 构建依赖（管理员身份运行 cmd/PowerShell）：

  npm install --global --production windows-build-tools
  

  或手动安装 Visual Studio Community，勾选「使用 C++ 的桌面开发」工作负载。

2. 降级 Node.js 版本 #

Node.js v22 属于较新版本，better-sqlite3 暂未适配，建议切换到 LTS 版本（如 v20）：

• 用 nvm-windows 管理版本：
  1. 安装 nvm-windows 后，执行：

     nvm install 20
     

  2. 切换到 v20：

     nvm use 20
     

3. 清理缓存后重新安装 #

• 清理 npm 缓存：

  npm cache clean --force
  

• 删除项目目录下的 node_modules 文件夹和 package-lock.json 文件
• 重新执行安装：

  npm install
  

4. 处理弃用警告（可选） #

弃用警告不影响功能，若需解决可更新对应包：

npm install @discordjs/collection@latest @discordjs/builders@latest

内容的提问来源于stack exchange，提问作者SACHIN K PADHIYAR