---
title: better-sqlite3 在 Node 24 上装不上，报找不到 prebuild
summary: pnpm 装 better-sqlite3 失败先看 Node 大版本，官方 prebuild 只覆盖到特定 ABI；实在没有就走 node-gyp 本地编译。
tags:
  - better-sqlite3
  - node
  - pnpm
  - windows
date: 2026-11-22T17:01:41.965Z
version: node@24
---
## 现象

```
npm i better-sqlite3
# gyp ERR! find VS  msvs_version not set from command line or npm config
```

或者装完了 `require('better-sqlite3')` 直接：

```
Error: The module '...\better_sqlite3.node' was compiled against a different Node.js version
```

## 原因

better-sqlite3 是原生模块，二进制按 NODE_MODULE_VERSION（ABI）区分。prebuild 只覆盖官方发版时的 Node 大版本；
换 Node 版本（比如 nvm 切到 24）后旧的 .node 文件 ABI 不匹配就报第二类错。第一类错说明当前 Node 没有 prebuild，
退回到了 node-gyp，而 Windows 上没装 VS Build Tools 就会 find VS 失败。

## 解决

先确认版本和 ABI：

```bash
node -p "process.versions.modules"
node -p "process.version"
```

有 prebuild 的路径（推荐）：

```bash
pnpm rebuild better-sqlite3
# 或者彻底重来
rm -rf node_modules && pnpm install
```

pnpm 里还有一个坑：pnpm 会忽略 postinstall 脚本，需要显式放行：

```bash
pnpm approve-builds          # 交互式勾选 better-sqlite3
# 或写进 package.json
# "pnpm": { "onlyBuiltDependencies": ["better-sqlite3"] }
```

真要本地编译（Linux/macOS 一般直接过）：

```bash
apt install -y build-essential python3
npm rebuild better-sqlite3 --build-from-source
```

## 注意

- Node 24 自带了 `node:sqlite`，纯读写场景可以不引 better-sqlite3；但它没有 FTS5 的完整可控性，做检索还是要 better-sqlite3。
- Electron 里要用 `electron-rebuild`，ABI 跟系统 Node 不同。
- 换 Node 版本后必须 rebuild，这条是反复踩的。