SQLTools 连接配置必须手动编写 JSON 文件，不支持 GUI 表单；Sublime 中通过 SQLTools: Edit Connections 打开 SQLToolsConnections.json，需严格校验字段大小写、类型（如 port 必须为数字）、必填项（如 database），且执行前须手动选择连接并确保对应 CLI 工具（mysql/psql/sqlite3）已在 PATH 中可用。
SQLTools 连接配置必须手动写 JSON，不能靠 GUI 填表
Sublime Text 没有数据库连接向导界面，SQLTools: Edit Connections 打开的是纯文本 SQLToolsConnections.json 文件，所有字段都要手写、手校验。常见错误包括："type": "mysql" 写成 "type": "MySQL"（大小写敏感），"port" 写成字符串 "3306"（必须是数字），漏掉 "database" 导致连接成功但无法默认选库。
实际配置建议用以下最小可用结构：
{
"dev_mysql": {
"type": "mysql",
"host": "127.0.0.1",
"port": 3306,
"user": "root",
"password": "your_pass",
"database": "test"
}
}
注意："type" 只支持小写固定值："mysql"、"postgresql"、"sqlite"、"mssql"；SQLite 不需要 host/port/user/password，只填 "database": "/path/to/db.sqlite" 即可。
执行前必须确认 CLI 工具在 PATH 中，否则报 Command not found
SQLTools 本身不带驱动，它只是把 SQL 发给系统已安装的命令行客户端——比如你配了 "type": "mysql"，它就会调用 mysql 命令；配了 "postgresql" 就调 psql。如果终端里运行 mysql --version 报错，Sublime 里执行必失败，错误信息通常是 sh: mysql: command not found 或类似。
验证和修复步骤：
- 在终端输入
which mysql（macOS/Linux）或where mysql（Windows），有输出才说明可用 - Mac 用户若用 Homebrew 安装，路径常为
/opt/homebrew/bin/mysql，需确保该路径加入 shell 的PATH（检查~/.zshrc） - Windows 用户装 MySQL Installer 时勾选 “Add to PATH”，或手动把
C:\Program Files\MySQL\MySQL Server X.X\bin加入系统环境变量 - SQLite 用户只需确认
sqlite3在 PATH 中（通常系统自带，Linux/macOS 默认有）
多数据库切换靠快捷键，不是靠文件后缀或侧边栏
Sublime 不会根据 .sql 文件名或所在目录自动匹配连接。每次执行前，必须先用快捷键或命令面板显式选择连接：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac） - 输入
SQLTools: Select Connection，从列表中选一个（如dev_mysql） - 再按
Ctrl+Shift+E执行当前选中语句或整个文件
这个动作不会记忆——下次打开新文件或重启 Sublime 后，仍需重新选一次。没有“默认连接”机制，也不能靠右键菜单自动识别上下文。
复杂查询模板要适配不同数据库语法，别直接复用
同一个 SELECT 语句，在 MySQL、PostgreSQL、SQLite 上可能因函数名、类型转换、LIMIT 语法而失败。例如：
-
LIMIT 10 OFFSET 20：MySQL/PostgreSQL 支持，SQLite 也支持，但旧版 SQLite 需用LIMIT 20,10 -
DATE(NOW())：MySQL 可用，PostgreSQL 要写CURRENT_DATE，SQLite 用date('now') -
CONCAT(a, b)：MySQL 支持，PostgreSQL 用a || b，SQLite 也支持||
调试时最省事的方式是：在对应数据库 CLI 里先跑通语句（mysql -u root -p -D test），再粘到 Sublime 执行。别指望插件做跨库语法兼容——它只转发，不翻译。
真正卡住人的地方从来不是配置几行 JSON，而是 CLI 工具没装对、PATH 没生效、或者以为选了连接就永久生效。连通性问题 90% 出现在这三步：which 命令查不到、JSON 字段拼错、执行前忘了手动选连接。
