Sublime Text 本身不能直接连数据库，SQLTools 是目前唯一能稳定支持多数据库轻量级查询的插件，但必须配齐命令行工具、正确配置 PATH 和连接参数，否则执行报错或无响应。
Sublime Text 本身不能直接连数据库，SQLTools 是目前唯一能稳定支持多数据库（MySQL、PostgreSQL、SQLite、SQL Server）轻量级查询的插件，但必须配齐命令行工具和正确配置，否则点执行只会报错或无响应。
SQLTools 安装失败或命令面板找不到？先确认 Package Control 是否真生效
很多人卡在第一步：按 Ctrl+Shift+P 输入 Install Package 没反应。这不是插件没装，而是 Package Control 自身没装好或被防火墙/代理拦截。
- 打开 Sublime 控制台（
Ctrl+`），粘贴官方安装命令（ST4 对应 SHA256 哈希值是8bc59f460fa1548d1514676163dafc88），回车后看有没有Error validating download - 如果控制台输出空白或报
urllib错误，说明网络不通——改用手动安装：官网下载Package Control.sublime-package，放进Packages目录（Preferences → Browse Packages…） - 重启后，在命令面板搜
Package Control: List Packages，能看到列表才算真正就位
执行 SQL 报错 “command not found” 或 “psql/mysql is not recognized”
SQLTools 不自带数据库客户端，它只是调用系统已安装的命令行工具。PATH 配置不对，插件根本找不到 mysql、psql 或 sqlite3。
- 在终端里直接运行
mysql --version、psql --version，确保能返回版本号；如果提示 command not found，说明没装或没加 PATH - Windows 用户尤其注意：MySQL 安装时勾选 “Add MySQL to PATH”；PostgreSQL 安装完要手动把
C:\Program Files\PostgreSQL\15\bin加进系统环境变量 - macOS / Linux 用户检查
which mysql输出路径，然后在 Sublime 的Preferences → Package Settings → SQLTools → Settings中显式指定："mysql": "/usr/local/bin/mysql"
连接配置写对了，但执行查询没结果或卡住
常见原因是连接参数格式不兼容或权限限制，尤其是密码含特殊字符、host 写成 localhost 却实际走 socket 连接。
- MySQL 连接中不要用
localhost，改用127.0.0.1，否则可能绕过 TCP 强制走 Unix socket，而mysqlCLI 默认不支持 socket 路径传参 - 密码含
$、@、/等字符时，必须 URL 编码（如@→%40），否则解析会截断 - PostgreSQL 的
database字段不能留空，哪怕只想连上不选库，也得填postgres或其他默认库名，否则psql启动失败 - 执行大结果集（>1000 行）时，
SQLTools默认不滚动，输出面板只显示前几行——这不是错误，是设计如此；想看全得导出为 CSV
为什么 .sql 文件右键没“Execute Query”选项？
这个菜单项依赖文件语法识别。如果当前文件没被识别为 SQL，右键就不会出现该命令。
- 新建文件后，先按
Ctrl+Shift+P输入Set Syntax: SQL，手动设为 SQL 语法；否则即使后缀是.sql，Sublime 也可能当成 plain text - 检查是否装了冲突插件，比如某些格式化插件会覆盖右键菜单；临时禁用其他 SQL 相关插件（如
SQLBeautifier）再试 - 确保文件已保存（有真实路径），未保存的临时文件有时触发不了连接上下文
最易被忽略的是：SQLTools 的连接配置必须写在 SQLTools.sublime-settings 里，而不是用户全局设置；且每个数据库连接块必须用英文逗号分隔，结尾不能有多余逗号——JSON 格式错误会导致整个配置静默失效，不报错也不连。
