查看“Better-sqlite3 安装问题排查”的源代码


如果你在安装<code>better-sqlite3</code>时遇到问题，请按照以下清单进行检查：

<br>

<span id="安装最新版本的node.js"></span>
== 安装最新版本的Node.js ==

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

<br>

== 安装<code>node-gyp</code>工具链 ==

# 确保你已经全局安装了[https://github.com/nodejs/node-gyp#installation <code>node-gyp</code>]。
# 确保所有的[https://github.com/nodejs/node-gyp#on-unix <code>node-gyp</code>依赖项已经安装]。在Windows上，你可能需要进行一些手动配置[https://github.com/nodejs/node-gyp#on-windows]。使用<code>npm ls node-gyp</code>来确保你的本地包没有安装一个过时版本的<code>node-gyp</code>，而这个版本被用作全局版本。

<br>

== 项目路径中没有特殊字符 ==

# 确保你的项目路径中没有空格：<code>node-gyp</code>可能无法正确转义空格或特殊字符（如<code>%</code>或<code>$</code>）。

<br>

<span id="electron"></span>
== Electron ==

# 如果你在使用[https://github.com/electron/electron Electron]，尝试运行[https://www.npmjs.com/package/electron-rebuild <code>electron-rebuild</code>]。

<br>

<span id="windows"></span>
== Windows ==

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

# 安装'''最新'''的Node 14、16、18或19。
# 安装'''最新'''的Visual Studio Community版和桌面开发C++扩展。
# 安装'''最新'''的Python。
# 运行以下命令：

<pre>npm config set msvs_version 2019
npm config set msbuild_path &quot;C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\MSBuildCurrent\Bin\MSBuild.exe&quot;</pre>
<ol start="5" style="list-style-type: decimal;">
<li>删除你的<code>node_modules</code>子目录。</li>
<li>删除你的<code>$HOME/.node-gyp</code>目录。</li>
<li>运行<code>npm install</code>。</li></ol>

<br>

== 如果以上方法都无效 ==

如果这些方法都无法解决你的问题，请浏览[https://github.com/JoshuaWise/better-sqlite3/issues?q=is%3Aissue 先前的问题]或者新开一个问题[https://github.com/JoshuaWise/better-sqlite3/issues/new]。

<br>