Better-sqlite3 安装问题排查

来自泡泡学习笔记
跳到导航 跳到搜索

如果你在安装better-sqlite3时遇到问题,请按照以下清单进行检查:


安装最新版本的Node.js

  1. 确保你使用的是Node.js v14.21.1或更高版本。
  2. 如果你使用的是Windows系统,在安装过程中,一定要选择”工具为本地模块”页面上的”自动安装必需工具”选项,并按照其余步骤操作,包括打开管理员PowerShell和安装Visual Studio以及Python。所有步骤_应该_都能顺利进行。


安装node-gyp工具链

  1. 确保你已经全局安装了node-gyp
  2. 确保所有的node-gyp依赖项已经安装。在Windows上,你可能需要进行一些手动配置[1]。使用npm ls node-gyp来确保你的本地包没有安装一个过时版本的node-gyp,而这个版本被用作全局版本。


项目路径中没有特殊字符

  1. 确保你的项目路径中没有空格:node-gyp可能无法正确转义空格或特殊字符(如%$)。


Electron

  1. 如果你在使用Electron,尝试运行electron-rebuild


Windows

如果你仍然在Windows上遇到问题并且使用的是较旧版本的Node,请尝试以下步骤:

  1. 安装最新的Node 14、16、18或19。
  2. 安装最新的Visual Studio Community版和桌面开发C++扩展。
  3. 安装最新的Python。
  4. 运行以下命令:
npm config set msvs_version 2019
npm config set msbuild_path "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuildCurrent\Bin\MSBuild.exe"
  1. 删除你的node_modules子目录。
  2. 删除你的$HOME/.node-gyp目录。
  3. 运行npm install


如果以上方法都无效

如果这些方法都无法解决你的问题,请浏览先前的问题或者新开一个问题[2]