根本原因是Sublime Text不自带数据库客户端，需系统已安装mysql/psql等命令并正确配置PATH；Windows须装sqlcmd或MySQL官方mysql.exe，macOS/Linux用brew安装并验证which命令；启动方式、Build System配置、语法包、补全文件及SQLBeautify设置均影响功能。
SQLTools 插件装完还报错：找不到 mysql 或 psql
根本原因不是插件没装好，而是 Sublime Text 本身不带任何数据库客户端——它只负责把 SELECT * FROM users; 这段文本发给系统里已安装的 mysql、psql 或 sqlite3 命令去执行。如果终端里敲 mysql --version 报 “command not found”，那 SQLTools 就一定失败。
确认方式很简单：Ctrl+Shift+P → 输入 SQLTools: Test Connection，如果弹出 [Errno 2] No such file or directory，就是 PATH 没配对。
- Windows 用户必须装 Microsoft 的
sqlcmd（SQL Server）或 MySQL 官方安装包里的mysql.exe，不能只装 Workbench；装完后重启 Sublime，再在终端运行sqlcmd -?或mysql -V验证 - macOS/Linux 用户用
brew install mysql-client postgresql sqlite3，然后检查which mysql是否返回路径 - PATH 看似配了但 Sublime 找不到？常见于 zsh/bash profile 里加了 PATH，但 Sublime 是从桌面图标启动的——此时需改用终端命令
subl启动编辑器，或重载 shell 环境变量
Build System 执行 SQL 文件时卡住或无输出
自定义 Build System 看似简单，但 cmd 字段一写错就静默失败。比如 MySQL 场景下写成 "cmd": ["mysql -u root -p testdb ，看起来像 Shell 命令，实际 Sublime 默认不走 shell 解析，<code> 符号直接被当参数传给 <code>mysql，导致连接后立刻退出。
正确写法必须明确启用 shell，并把整条命令包进字符串：
{
"cmd": ["mysql", "-u", "root", "-p", "testdb", "-e", "source $file"],
"selector": "source.sql",
"shell": true
}-
$file是 Sublime 内置变量，表示当前文件绝对路径；别手抖写成$file_path或${file}，后者不识别 -
shell: true在 Windows 下是刚需，否则mysql根本找不到；macOS/Linux 可设为false提升安全性，但得确保cmd数组每个元素都拆开（如"-e"和"source $file"必须分开） - 密码明文写在 build 文件里极不安全，生产环境应改用
~/.my.cnf配置文件，避免-p参数
SQL 关键字不高亮、补全没反应
这不是插件问题，而是 Sublime 默认不把 .sql 文件绑定到 SQL 语法。右下角显示 “Plain Text” 或 “MySQL” 都不对——前者没高亮，后者其实是旧版非标准语法包，连 WITH RECURSIVE 都不识别。
- 手动切换：点击右下角语法名 → 选
SQL > SQL（注意路径，不是SQL > MySQL） - 永久绑定：右键文件标签 →
Set Syntax: SQL→Apply to All Files with Same Extension - 如果菜单里压根没
SQL选项，说明没装官方SQL语法包：用 Package Control 安装SQL（不是SQLTools，也不是SublimeSQL） - 自动补全失效？检查
Packages/User/目录下有没有.sublime-completions文件，内容必须是 JSON 数组格式，"trigger": "se"才能触发SELECT，写成"sel"就没响应
SQLBeautify 格式化后缩进错乱或关键字变小写
SQLBeautify 默认风格是 PostgreSQL 兼容型，会把所有关键字转成小写、用 2 空格缩进。如果你习惯 SELECT 大写 + 4 空格，就得手动改配置。
- 按
Ctrl+Shift+P→ 输入SQLBeautify: Settings – User，打开用户配置文件 - 关键字段：
"keyword_case": "upper"、"indent_size": 4、"comma_style": "first"（逗号前置） - 格式化范围默认是全文，选中部分再按快捷键
Ctrl+Shift+B才只处理选区；没选中就整文件重排，大表结构脚本可能崩格式 - 别指望它识别自定义函数或存储过程语法——它只认标准 SQL，遇到
CREATE OR REPLACE FUNCTION可能切错块
真正麻烦的是跨库兼容性：同一个 .sql 文件里混着 MySQL 的 INTO OUTFILE 和 PostgreSQL 的 RETURNING，格式化工具会按第一个识别到的方言处理，结果两边都不对。这种场景不如分文件、分 Build System、分连接配置来得实在。
