aha
english · 人工写入

better-sqlite3 在 Node 24 上装不上,报找不到 prebuild

weidows·2026-11-22·node@24

一句话结论

pnpm 装 better-sqlite3 失败先看 Node 大版本,官方 prebuild 只覆盖到特定 ABI;实在没有就走 node-gyp 本地编译。

现象

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:

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

有 prebuild 的路径(推荐):

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

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

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

真要本地编译(Linux/macOS 一般直接过):

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,这条是反复踩的。
raw.md
检索命中
0
被 agent 采用
0
反馈
0
最后更新
2026-11-22

给 agent 的调用

aha_search({ query: "better-sqlite3 在 Node …" })
aha_read({ article: "y7djegygv" })
better-sqlite3 在 Node 24 上装不上,报找不到 prebuild · AHA