sqltools不适合管理多个本地sqlite文件，因其将sqlite误作远程数据库处理，强制要求host/port配置、不支持相对路径与变量、需为每个.db文件单独维护json连接定义，且静默失败多（如连错库不报错、不识别.sqlite3命令、中文乱码无提示）。
直接用 Build System 调用 sqlite3 是最稳、最轻、最不踩坑的方式，尤其当你面对多个本地 .db 文件时——SQLTools 对 SQLite 支持弱，配置冗余，还容易因路径或权限卡死。
为什么 SQLTools 不适合管理多个本地 SQLite 文件
SQLTools 名义上支持 SQLite，但实际使用中它把 SQLite 当成“远程数据库”处理：要填 host、port，连接配置里还得写 "type": "sqlite"（注意不是 sqlite3 或 sqlit3，错一个字符就静默失败）；更关键的是，它不接受相对路径或变量（如 $file），每次换库都得手动改 JSON 配置。你有 5 个 .db 文件？就得维护 5 套连接定义，且无法一键切换。
常见错误现象包括：
-
Connection failed: no such table—— 实际是连错了文件，但插件没报错，只返回空结果 - 执行
.tables或.schema报语法错误 —— 因为 SQLTools 只转发标准 SQL，不识别 sqlite3 命令行特有指令 - 中文字段名显示乱码 —— 插件默认用 UTF-8 解析输出，但某些系统生成的
.db是 GBK 编码，无提示、无 fallback
用 Build System 直接调用 sqlite3 的实操步骤
这是 Sublime 管理多个本地 SQLite 文件的黄金路径：每个 .db 文件对应一个独立 Build System，执行即查，无需配置连接，不依赖 Python 环境，Windows/macOS/Linux 全兼容。
操作要点：
- 菜单栏 → Tools → Build System → New Build System，粘贴以下内容（注意替换
/path/to/your.db为实际路径）：
{
"cmd": ["sqlite3", "/path/to/your.db", ".mode column", ".headers on", "-line", "$file"],
"selector": "source.sql",
"file_regex": "^([^:]+):([0-9]+):?([0-9]+)?:? (.*)$"
}
-
$file必须是.sql脚本路径，而命令中第一个参数必须是.db文件绝对路径 —— 所以每个库需单独建一个 Build System - 想查表结构？在
.sql文件里写SELECT name FROM sqlite_master WHERE type='table';，别用.tables - Windows 用户确认
sqlite3.exe在PATH中，否则报错Unable to find command sqlite3 - 输出自动对齐列宽、带表头，但不支持分页 —— 查超 1000 行建议加
LIMIT 100
如何快速切换不同 .db 文件的查询环境
不用反复新建 Build System，用 Sublime 的「多光标 + 复制粘贴」配合模板文件即可实现秒切。
推荐做法：
- 在项目根目录建一个
_builds/文件夹，里面放多个预设 Build System 文件，例如：app_prod.sublime-build、app_dev.sublime-build、logs.sqlite.sublime-build - 每个文件里只改
"cmd"第一项路径，其余保持一致 —— 这样你双击打开就能立刻执行对应库 - 把常用查询语句存成 snippets（如
SELECT * FROM users LIMIT 10;），绑定快捷键Ctrl+Alt+U，避免手敲 - 右键 → Build With… 可直接选择目标库，比进菜单快 3 步
真正麻烦的不是“怎么连”，而是 SQLite 文件本身没有服务进程、不校验连接状态、不锁文件 —— 你用 Sublime 查的时候，另一个程序可能正在写入，结果看到的是脏读或报错 database is locked。这点没人提醒，但你得自己心里有数。
