Better-sqlite3 安装问题排查
跳到导航
跳到搜索
安装
如果你在安装better-sqlite3
时遇到问题,请按照以下清单进行检查:
安装最新版本的Node.js
- 确保你使用的是Node.js v14.21.1或更高版本。
- 如果你使用的是Windows系统,在安装过程中,一定要选择”工具为本地模块”页面上的”自动安装必需工具”选项,并按照其余步骤操作,包括打开管理员PowerShell和安装Visual Studio以及Python。所有步骤_应该_都能顺利进行。
安装node-gyp
工具链
- 确保你已经全局安装了
node-gyp
。 - 确保所有的
node-gyp
依赖项已经安装。在Windows上,你可能需要进行一些手动配置[1]。使用npm ls node-gyp
来确保你的本地包没有安装一个过时版本的node-gyp
,而这个版本被用作全局版本。
项目路径中没有特殊字符
- 确保你的项目路径中没有空格:
node-gyp
可能无法正确转义空格或特殊字符(如%
或$
)。
Electron
- 如果你在使用Electron,尝试运行
electron-rebuild
。
Windows
如果你仍然在Windows上遇到问题并且使用的是较旧版本的Node,请尝试以下步骤:
- 安装最新的Node 14、16、18或19。
- 安装最新的Visual Studio Community版和桌面开发C++扩展。
- 安装最新的Python。
- 运行以下命令:
npm config set msvs_version 2019 npm config set msbuild_path "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuildCurrent\Bin\MSBuild.exe"
- 删除你的
node_modules
子目录。 - 删除你的
$HOME/.node-gyp
目录。 - 运行
npm install
。
如果以上方法都无效
如果这些方法都无法解决你的问题,请浏览先前的问题或者新开一个问题[2]。