sublime text 不能直接连接数据库或执行 sql 查询，所有功能均依赖本地 cli 工具（如 mysql、psql）；成功前提仅为三者：工具已安装、path 可访问、能安全执行，跳过终端验证 mysql --version 则后续配置必失败。
Sublime Text 不能直接连接数据库或执行 SQL 查询——它不是数据库客户端，没有内置驱动、连接池或查询引擎。所谓“一键运行”，本质是调用你本地已安装的 mysql、psql 或 sqlite3 等 CLI 工具。能否成功，只取决于三件事：工具是否装好、能否被找到、能不能安全执行。
确认 mysql/psql/sqlite3 能在终端里直接运行
这是所有方案的前提，跳过这步，后面全卡住。
- 打开系统终端（macOS/Linux 的 Terminal，Windows 的 PowerShell 或 CMD），输入
mysql --version或psql --version，必须能输出版本号；否则说明没装或没加到PATH - 如果提示
command not found，别急着配插件——先去官网下载对应数据库的命令行客户端（比如 MySQL 官网的 MySQL Client，PostgreSQL 的 StackBuilder 或完整安装包），装完后重启 Sublime（它不自动继承新 PATH） - Windows 用户特别注意：
mysql.exe和psql.exe必须在系统 PATH 中，或你得写绝对路径，例如"C:\Program Files\MySQL\MySQL Server 8.0\bin\mysql.exe"（注意双反斜杠）
用 Build System 实现最轻量的一键执行
适合只查一两个库、不想装 Node.js 或折腾插件的人。本质就是让 Ctrl+B 触发一条 shell 命令。
- 菜单栏 → Tools → Build System → New Build System，粘贴以下内容（以 MySQL 为例）：
{
"cmd": ["mysql", "-h", "localhost", "-u", "root", "-p", "mydb", "-e", "source $file"],
"selector": "source.sql",
"shell": true,
"working_dir": "$file_path"
}
-
-p后不要跟密码——否则明文泄露；删掉它，运行时会弹窗输密码；更安全的做法是用--defaults-file指向一个只读的配置文件（如~/.my.cnf） -
$file是当前 .sql 文件的完整路径，source $file让 mysql 执行整个脚本；如果只想执行选中的片段，得换插件或改写命令（Build System 不支持选区传参） - 保存为
MySQL.sublime-build，然后右上角 Build System 选它；按 Ctrl+B 即可执行 - 错误默认不显示？加
"quiet": false到 cmd 同级，或建 variant：
"variants": [
{
"name": "Run with stderr",
"cmd": ["mysql", "-h", "localhost", "-u", "root", "-p", "mydb", "-e", "source $file"],
"quiet": false
}
]
SQLTools 插件：功能多但链路长
它是目前唯一持续维护、支持 MySQL/PostgreSQL/SQLite 的插件，但不是“装完就能用”。
- 必须先装 Node.js（v16+），SQLTools 后端靠它跑；没装就报错
node is not available - 插件设置里填对
executablePath：macOS 上可能是/usr/local/bin/psql，Windows 上常见C:\Program Files\PostgreSQL\bin\psql.exe；路径错，连连接选项都点不出来 - 连接参数写在
connections.json里，密码别明文写，用${env:PGPASSWORD}或${env:MYSQL_PWD}引用环境变量 - 每条查询都是独立进程启动：
BEGIN后跟COMMIT在不同命令间无效——它不维持会话，不支持事务延续
为什么点了 Ctrl+B 没反应？常见断点在哪
不是插件坏了，大概率是环境链某处断了。
- Sublime 没继承系统 PATH：即使终端里
mysql能跑，Sublime 可能找不到——解决办法：从终端启动 Sublime（macOS：open -a "Sublime Text"；Linux：subl；Windows：用 PowerShell 启动） - Build System 的
selector没匹配上：确保文件后缀是.sql，且语法设为 SQL（右下角点击切换，或按 Ctrl+Shift+P → Set Syntax: SQL） - SQL 文件开头有 BOM（UTF-8 with BOM）：mysql 会报错
Unknown command；用 Sublime → File → Save with Encoding → UTF-8（无 BOM）重存 - 权限问题：Linux/macOS 下，如果 mysql.sock 路径不对或权限受限，会卡住无输出；建议优先用
-h 127.0.0.1（TCP）而非-h localhost（可能走 socket）
