Sublime Text 无法直接运行 SQL，需通过调用系统 mysql CLI 或 SQLTools 插件实现；前者轻量可控但需配置 Build System 并确保 mysql 在 PATH 中，后者功能丰富但依赖 Node.js 且环境链复杂，均不支持事务延续或实时会话。
Sublime Text 本身不支持直接运行 SQL 查询
它不是数据库客户端，没有内置连接 MySQL 的能力。你看到的“Sublime 运行 SQL”效果，基本都是靠外部命令调用 mysql CLI 工具实现的——也就是说，真正执行查询的是系统里装好的 MySQL 客户端，Sublime 只负责把文件内容传过去、把结果捞回来。
所以第一步不是配 Sublime，而是确认本地有没有可用的 mysql 命令：
- 终端/命令行输入
mysql --version，有输出说明已安装且在$PATH中 - 如果报
command not found，得先装 MySQL Client（不用装完整服务端），或把mysql所在路径加进系统环境变量 - Windows 用户常见坑：MySQL Installer 默认不勾选 “Add MySQL to PATH”，要手动补上
bin目录（比如C:\Program Files\MySQL\MySQL Server 8.0\bin）
用 Build System 调用 mysql 命令执行 .sql 文件
这是最轻量、最可控的方式，适合写好脚本后一键执行，不依赖插件稳定性。
操作步骤：
- 在 Sublime 中打开一个
.sql文件（比如query.sql） - 菜单栏 → Tools → Build System → New Build System…
- 替换全部内容为以下 JSON（按需改
host、user、database）：
{
"cmd": ["mysql", "-h", "localhost", "-u", "root", "-proot", "mydb", "-e", "source $file"],
"selector": "source.sql",
"working_dir": "$file_path"
}
注意几个关键点：
-
-proot是密码参数，不能有空格，且明文暴露在配置里——开发机可接受，别放 Git 或共享环境 -
source $file表示执行当前文件，$file是 Sublime 的变量，会自动展开为绝对路径 - 如果 SQL 文件里含中文或特殊字符，Windows 下可能乱码，可在
cmd数组开头加"chcp 65001 >nul &&"切 UTF-8 - 执行后错误信息（比如
ERROR 1045 (28000): Access denied）会直接显示在 Sublime 底部面板，方便定位权限或连接问题
SQLTools 插件能连 MySQL，但依赖 Node.js 和额外服务
它比纯 Build System 功能多（语法高亮、表结构浏览、结果表格化），但也更重、更容易卡在环境环节。
常见失败原因：
- 没装
node或版本太低（要求 >= 14.x），运行node -v确认 - 插件安装后必须重启 Sublime，否则
SQLTools: Connect命令不出现 - 连接配置里填的
host是 MySQL 实际监听地址，不是127.0.0.1就一定通——有些 MySQL 默认只绑127.0.0.1，而 Docker 或远程库要用真实 IP 或0.0.0.0 - 如果提示
Connection refused，先用命令行mysql -h xxx -u yyy -p手动试一次，排除网络和权限问题
别指望 Sublime 做实时查询或事务管理
它没有会话保持机制。每次 Build 或 SQLTools 执行，都是一次全新连接 —— BEGIN 开的事务不会延续到下一次查询，变量（如 @var := 1）也不会跨执行生效。
这意味着：
- 想测事务逻辑？老实用
mysqlCLI 或 DBeaver 这类专业客户端 - 复杂调试场景（比如带临时表、多步依赖），建议拆成小段，用 Build System 分别执行，再看中间结果
- SQLTools 的“Query History”只存语句文本，不存执行上下文，别把它当 MySQL Workbench 用
真正的难点从来不在怎么让 Sublime “看起来能跑 SQL”，而在于理清：哪部分该由编辑器辅助，哪部分必须交给数据库工具完成。环境链越长（Sublime → 插件 → Node → MySQL Driver → MySQL Server），出问题时排查路径就越绕。
