能直接操作，但必须注意路径、连接时机和插件干扰这三件事：数据库路径需用path.join(__dirname, ...)确保准确；node.js进程与vscode sqlite插件可能因文件锁冲突导致数据“消失”；db.run()等操作必须传回调并检查err，否则错误被静默吞没。
能直接操作，但必须注意路径、连接时机和插件干扰这三件事。 VSCode 本身不参与数据库运行，它只是编辑器；真正执行 SQL 的是 Node.js 进程 + sqlite3 模块。很多“查不到数据”“表不存在”“插入没反应”的问题，根源不在代码，而在文件路径没对上、数据库被多个进程同时打开，或 VSCode 插件偷偷创建了同名临时库。
确认 sqlite3 已正确安装且能被 Node.js 加载
别只看 npm install sqlite3 是否成功——这个模块含原生编译组件，在不同系统（尤其是 M1/M2 Mac 或 Windows WSL）上容易 silently fail。运行后立刻验证：
- 在项目根目录执行
node -e "require('sqlite3')"，无报错才算加载成功；报Error: Cannot find module 'sqlite3'或Module did not self-register，说明安装失败，需重装或加--build-from-source - 如果用 Electron 或打包工具（如 pkg），
sqlite3必须 rebuild 对应目标平台的二进制，否则运行时崩溃 - VSCode 的集成终端（Terminal）默认复用同一 shell 环境，但如果你开了多个终端窗口，确保都在项目根目录下运行，否则
require可能找不到本地 node_modules
数据库路径必须用相对路径或绝对路径，不能依赖 VSCode 当前打开的文件夹
new sqlite3.Database('./data.db') 中的 ./ 是相对于 Node.js 进程启动时的 process.cwd()，不是 VSCode 工作区根目录，更不是你当前打开的 .js 文件所在目录。这是最常踩的坑。
- 错误做法：把
db.js放在src/下，然后在 VSCode 终端里 cd 到src/再跑node db.js→ 此时./data.db会落在src/data.db，而非你预期的项目根目录 - 推荐写法：
const db = new sqlite3.Database(path.join(__dirname, '../data.db'))，用__dirname锁定脚本所在位置，再向上找 - 调试时加一行
console.log('DB path:', path.resolve(__dirname, '../data.db'))，直接看到真实路径，比猜强十倍
避免 VSCode SQLite 插件与 Node.js 进程冲突
当你用 SQLite Viewer 或 SQLTools 打开一个 .db 文件时，这些插件会自己打开该文件并持有读锁（某些情况甚至写锁）。此时 Node.js 调用 sqlite3.Database() 可能卡住、静默失败，或——更糟——创建一个同名但空的新库（尤其在 Windows 上）。
- 现象：Node.js 插入数据后查不到，但插件里能看到；删掉 .db 文件后插件仍能“连上”，说明它在内存或缓存里维护了一份影子库
- 解决办法：操作数据库期间，关掉所有 VSCode 中已打开的 .db 文件标签页；或者右键 → “Close Editor”，不要只靠 Ctrl+W 关闭标签而没释放句柄
- SQLTools 尤其危险：它默认启用“Auto Connect”，即使你没主动点连接，只要文件存在就可能预加载。可在设置里搜
sqltools.sqlite.autoConnect设为false
db.run() 和 db.all() 的回调时机与错误捕获不能省
sqlite3 是异步但非 Promise 化的 API，所有操作都通过回调通知完成。漏写回调或忽略 err 参数，等于把错误吞进黑洞。
-
db.run()用于 INSERT/UPDATE/DELETE，必须传回调，否则无法知道是否成功；this.lastID和this.changes只在回调函数内有效 -
db.all()查询必须传回调，第二个参数才是结果数组；写成db.all('SELECT * FROM t', console.log)看似省事，但出错时只会打印null，掩盖真实错误 - 建议统一加
if (err) { console.error('SQL error:', err.message); return; }，哪怕只是开发期快速定位
真正麻烦的从来不是语法，而是 Node.js 进程、SQLite 文件锁、VSCode 插件生命周期这三者在后台无声地互相掐架。每次数据“消失”，先检查路径是否真实存在、插件是否还占着文件、终端 pwd 是否是你以为的那个目录——比重写 SQL 更快解决问题。
