sqltools 在 sublime text 中无法运行 sqlite 查询，根本原因是 sqlite3 命令未安装或未加入系统 path，导致插件无法调用；必须确保 sqlite3 --version 可执行，并在插件配置中严格使用绝对路径、小写 driver 和显式 executable 路径。
Sublime Text 本身不支持直接连接或管理 SQLite 数据库，所谓“安装 SQLite 管理工具”实际是配置外部命令行工具 + 插件协作完成查看与执行操作。核心前提是：sqlite3 命令必须在终端/命令行中可用，否则任何插件都起不来。
为什么 SQLTools 插件无法运行 SQLite 查询
SQLTools 是 Sublime Text 上最常用的数据库插件，但它对 SQLite 的支持依赖于系统能否调用 sqlite3 可执行文件。常见失败现象包括：
- 右键执行 SQL 时无响应，或输出面板只显示“command not found”
- 插件设置里填了
database路径，但提示 “no such file or directory”（其实是找不到sqlite3） - 即使数据库文件存在，
.tables或SELECT *也报错退出
根本原因不是插件配置错了，而是 sqlite3 没装、没加进 PATH，或者路径含中文/空格导致 Sublime 子进程启动失败。
确保 sqlite3 在命令行和 Sublime 中都可用
先验证基础环境是否就位：
- 打开终端（CMD/PowerShell/Terminal），输入
sqlite3 --version，有输出即说明已安装且在PATH - 若提示“不是内部或外部命令”，请按官方方式安装：
– Windows：从 sqlite.org/download.html 下载sqlite-tools-win32-*.zip，解压后把目录加进系统PATH
– macOS：用brew install sqlite3，确认/usr/local/bin/sqlite3存在并可执行
– Linux（Ubuntu/Debian）：运行sudo apt install sqlite3 - Sublime 启动时默认继承系统
PATH，但如果你用桌面图标启动，某些 Linux/macOS 桌面环境会丢掉自定义PATH—— 此时建议从终端启动 Sublime：subl .
SQLTools 插件配置 SQLite 连接的关键项
安装好 SQLTools 后，它不自动识别 SQLite；你必须手动添加一个连接配置。在 Sublime 的 Preferences → Package Settings → SQLTools → Settings 中，修改 connections 部分：
{
"connections": {
"mydb": {
"driver": "sqlite",
"database": "/path/to/your/app.db",
"executable": "/usr/local/bin/sqlite3"
}
}
}
注意几个硬性要求：
-
driver必须写成"sqlite"（小写，不能是SQLite或sqlite3） -
database值必须是绝对路径，Windows 上用正斜杠或双反斜杠，例如C:/project/data.db或C:\project\data.db -
executable推荐显式指定（尤其 macOS/Linux），避免插件自己找错版本；Windows 通常可省略，前提是sqlite3.exe已在PATH - 路径中不能含未转义的空格或中文，否则子进程启动失败 —— 最稳妥做法是把数据库文件放在纯英文路径下
替代方案：不用插件，直接用 Sublime + 终端协同操作
如果你只是偶尔查表结构、导出几条数据，SQLTools 反而容易卡在配置环节。更轻量的做法是：
- 用 Sublime 编辑
.sql文件（比如写好SELECT * FROM users LIMIT 10;） - 保存后，在终端中执行：
sqlite3 myapp.db - 配合
.mode column和.headers on，结果可读性不输 GUI - 需要快速看 schema？在终端运行：
sqlite3 myapp.db ".schema users"
这种组合绕过了插件兼容性问题，也避开了 Windows 下 PowerShell 对重定向符号的特殊处理（如需兼容，改用 CMD 或加引号）。
真正容易被忽略的是：SQLite 的“数据库”本质就是一个普通文件，没有服务、没有端口、没有用户权限。所有管理动作最终都落在文件读写和 sqlite3 命令解析上。只要这个二进制程序能跑通，剩下的只是路径、权限、编码这些底层细节 —— 而不是插件功能强不强的问题。
