sqltools并非开箱即用,必须同时安装并启用对应数据库的driver插件,配置通过connections.json管理,执行前需手动连接且右下角显示绿色图标。

SQLTools 是目前最可靠、开箱即用的数据库维护插件,它能直接连接 MySQL/PostgreSQL/SQLite,执行语句并展示结果,不用切出编辑器。
SQLTools 安装失败的常见原因和绕过方法
它依赖 Package Control,但很多人卡在第一步:Package Control 本身没装对。ST4(2026 年主流版本)必须用官网带 hashlib.sha256 校验的 Python 脚本安装,旧版 urllib2 或缺校验值的代码会静默失败——控制台显示 Successfully installed,但 Ctrl+Shift+P 输入 Package Control: Install Package 无响应。
- 打开控制台:
Ctrl + `(反引号) - 粘贴 packagecontrol.io 页面标为 “Sublime Text 4” 的完整脚本(含
h = 'df21e130' + 'eea76'这类 SHA256 值) - 执行后看到
Successfully installed,然后必须重启 Sublime Text - 重启后按
Ctrl+Shift+P输入Package Control: Install Package,左下角出现Fetching list of available packages才算真正就位 - 若仍无反应,先执行
Package Control: Synchronize Sources;公司网络开了代理时,临时关闭再试
SQLTools 连接 PostgreSQL 报错 “connection refused” 怎么调
这不是插件问题,而是默认配置试图连本地 localhost:5432,但你的 PostgreSQL 实例可能监听的是 127.0.0.1、Unix socket,或端口被改过。SQLTools 的连接配置不走系统环境变量,得手动填全。
- 右键 SQL 文件 →
SQLTools: New Connection,或通过命令面板调用 -
host别写localhost,改用127.0.0.1(绕过 IPv6 解析失败) -
port显式填5432,哪怕你认为它是默认值 -
database必须填真实库名,不能留空或填postgres(除非你真要连系统库) - 密码错误或用户没权限时,报错是
password authentication failed,和connection refused是两回事,别混诊
SQLBeautify 和 SQLTools 能不能一起用
可以,而且推荐。SQLTools 负责执行和连接,SQLBeautify 负责格式化——它们不冲突,但快捷键容易记混。
- SQLBeautify 默认格式化快捷键:
Ctrl+K然后Ctrl+F(Windows/Linux),Cmd+K然后Cmd+F(macOS) - SQLTools 执行当前语句是
Ctrl+Enter(Windows/Linux),Cmd+Enter(macOS) - 如果选中了一段 SQL 再按
Ctrl+Enter,SQLTools 只执行选中部分;没选中则执行光标所在完整语句(以分号结尾) - SQLBeautify 不读取连接配置,也不需要数据库在线,纯本地文本处理,所以即使断网也能用
真正容易被忽略的是语法识别:SQLTools 对文件后缀敏感,.sql 文件自动启用,但如果你在 .txt 或无后缀的临时文件里写 SQL,得手动右下角点击语法名 → 选 SQL,否则 Ctrl+Enter 不触发执行。











