node-sqlite3操作需绕开vscode连接概念，依赖本地node进程；安装要注意abi兼容性，路径须绝对且父目录存在，写入后须检查this.changes和this.lastid，批量操作用serialize，调试时务必显式close并处理进程退出。
能直接操作，但必须绕开 VSCode 自身的“连接”概念——它不提供 Node 运行时，所有数据库操作都发生在你自己的 Node 进程里，VSCode 只是编辑器和调试器。
Node.js 项目里装 sqlite3 模块要留意 ABI 兼容性
sqlite3 是 C++ 编写的原生模块，安装时会尝试编译适配当前 Node 版本的二进制。如果失败，常见现象是 Cannot find module 'sqlite3' 或 Module version mismatch 错误。
- 先确认 Node 版本：
node -v（比如 v20.15.0），再运行npm install sqlite3 - 若报错，优先用
npm install sqlite3 --build-from-source强制本地编译 - Electron 项目必须额外指定 runtime 和 arch：
npm install sqlite3 --runtime=electron --target=32.2.0 --dist-url=https://electronjs.org/headers（target 版本需匹配你用的 Electron） - Windows 用户遇到 Python / MSBuild 报错，装
npm install --global windows-build-tools（或改用 WSL）
Database 实例初始化时路径必须存在且可写
new sqlite3.Database() 不会自动创建父目录，只负责建库文件本身。路径错误导致静默失败或 SQLITE_CANTOPEN。
- 推荐用
path.resolve(__dirname, 'data', 'app.db')构造绝对路径，避免相对路径在不同工作目录下失效 - 确保
data/目录已存在，否则加一层判断：fs.mkdirSync(path.dirname(dbPath), { recursive: true }) - Windows 上路径含空格或中文一般没问题，但 Electron 打包后可能因 ASAR 封装限制无法写入，此时必须把 db 放到
app.getPath('userData')下 - 不要用
./db.sqlite直接传给Database构造函数——它不会帮你 resolve，容易在 CLI 启动 vs Code 调试时指向错误位置
执行 INSERT/UPDATE/DELETE 必须检查 this.changes 和 this.lastID
db.run() 的回调里 this 是语句执行上下文对象，不是 db 实例。漏看 this.changes 容易误判写入是否成功。
-
INSERT成功后this.lastID是新行 rowid，this.changes是 1；失败时this.changes仍为 0，但err非 null -
UPDATE或DELETE即使 where 条件没命中，也不会报错，this.changes为 0 —— 这是正常行为，不是 bug - 别依赖
err === null就认为数据已改：要同时判断err和this.changes - 批量操作慎用
run，改用serialize()包裹多个语句，否则事务不生效
VSCode 调试时 db.close() 容易被忽略导致文件锁残留
SQLite 文件被 Node 进程打开后，若未显式关闭，Windows 下常出现 EBUSY: resource busy or locked，Mac/Linux 表现为后续写入卡住或静默丢弃。
- 在
process.on('SIGINT', ...)和process.on('exit', ...)中调用db.close()，并等待回调完成 - 调试时断点停在
db.close()前就终止进程，锁不会释放——关掉调试器后手动杀掉对应 node 进程 - 开发阶段可用
sqlite3.verbose()开启日志，看到SQLITE_BUSY提示时，立刻检查是否有其他 Node 实例或 VSCode 插件（如 SQLTools）正占用同一 db 文件 - 生产环境建议用
sqlite3.Database的configure('busyTimeout', 3000)设置重试，而不是硬等
真正麻烦的从来不是语法，而是路径、权限、并发和生命周期管理——尤其当 VSCode 同时开着 SQLTools 插件和你的 Node 调试会话时，两个进程对同一个 .db 文件的读写冲突几乎必然发生，得靠人工协调关闭顺序。
