sublime text 无法直接管理 sql 数据库，所有 sql 功能均依赖本地 cli 工具（如 mysql、psql）及其正确调用；语法高亮需手动绑定 sql 语法，构建执行需配置对应 build system，sqltools 连接失败多因 executablepath 路径错误或环境变量不一致，格式化需预装 sqlparse，补全依赖静态 json 触发词，大文件卡顿需调大 max_file_size 和 fold_level。
Sublime Text 本身不能连接、执行或管理 SQL 数据库——所有“高亮”“补全”“运行”“格式化”功能，都依赖你本地是否装好对应 CLI 工具（mysql、psql、sqlite3），以及它们能否被 Sublime 正确调用。配置失败的根源，90% 不在 Sublime 设置里，而在终端能跑、GUI 环境却找不到命令。
为什么 .sql 文件打开没高亮？Syntax 没绑对，不是插件没装
Sublime 默认不把 .sql 文件当 SQL 处理，右下角显示 Plain Text 或 MySQL 就说明识别路径错了。
- 手动切换：点右下角当前语法名 → 选
SQL（注意是顶层SQL，不是MySQL或PL/SQL） - 永久绑定：切换后右键文件标签 →
Set Syntax: SQL→ 再点Apply to All Files with Same Extension - 如果列表里压根没有
SQL选项，说明缺官方语法包：用Package Control: Install Package安装SQL（作者必须是sublimelsp，别装错旧包） - 验证方式：写
SELECT * FROM users;，关键字应立刻变蓝/粗体；否则检查Packages/SQL/SQL.tmLanguage是否存在
Ctrl+B 执行 SQL 没反应？Build System 配错了或 CLI 不可用
Sublime 不执行 SQL，只是调用你系统里的 mysql 或 psql。快捷键失效，几乎全是命令根本跑不起来。
- 先在终端确认：
mysql --version或psql --version必须能输出版本号 - Windows 用户特别注意：
PATH是否包含mysql.exe所在目录（如C:\Program Files\MySQL\MySQL Server 8.0\bin），改完要重启 Sublime - 新建 Build System：
Tools > Build System > New Build System，填入（以 MySQL 为例）：
{
"cmd": ["mysql", "-u", "root", "-p", "testdb", "-e", "source $file"],
"selector": "source.sql",
"shell": true
}
-
$file是当前文件绝对路径，别写成$file_path或漏引号；"shell": true在 Windows 下必须加，否则找不到命令 - 保存为
MySQL.sublime-build，然后在Tools > Build System中选它；按Ctrl+B（不是Ctrl+Enter）触发构建
SQLTools 连不上数据库？executablePath 和方言没对上
SQLTools 不是客户端，它只是拼出一条类似 psql -h localhost -U postgres 的命令去调系统 CLI。所谓“配置连接”，本质是告诉插件怎么拼这条命令。
- 安装前提：已装
Node.js，且psql/mysql/sqlite3在终端能直接运行 - 连不上第一查
executablePath：GUI 启动的 Sublime 环境变量常和 shell 不一致，macOS M1/M2 用户建议填绝对路径，比如"executablePath": "/opt/homebrew/bin/psql" - Windows 用户若
mysql --version报错，把 MySQLbin目录加进系统PATH，再重启 Sublime - Linux/macOS：运行
which sqlite3，把结果填进 SQLTools 设置里的executablePath字段；别留空 - 右下角点击语法名，手动选对应方言（
PostgreSQL、MySQL等），这直接影响括号匹配、关键字着色和注释行为
格式化乱、补全不弹、大文件卡？sqlparse 和 fold_level 得手动设
SQLBeautifier 是目前最稳的本地格式化方案，但必须配对 sqlparse 才生效；补全是静态 JSON 触发，不是动态分析表结构；大文件卡顿是 Sublime 默认限制了折叠层级和文件大小。
- 格式化前必须
pip install sqlparse，否则插件走降级逻辑，INSERT ON CONFLICT这类语法会直接崩掉高亮 - 补全文件放在
Packages/User/目录下（用Preferences > Browse Packages打开），内容为 JSON 格式，例如：
[{"trigger":"sel","contents":"SELECT"},{"trigger":"fr","contents":"FROM"}]
- 触发词区分大小写；想打
se出SELECT，就得写"trigger": "se" - 大文件卡顿？修改
Preferences > Settings – User，加这两行：
"max_file_size": 8388608,"fold_level": 5
真正容易被忽略的是：Sublime 的 GUI 环境变量和终端不一致，哪怕你在 zsh 里 which psql 有结果，Sublime 仍可能报 command not found——这时候填绝对路径比折腾 PATH 更快更可靠。
