sublime text 本身不带数据库管理功能，需通过插件（如 sqltools）配合外部命令行客户端实现；必须正确配置 mysql 的 bin 路径到系统 path 或插件设置中，并填写完整连接参数，否则会因找不到 mysql 命令或配置错误而报错。
Sublime Text 本身不带数据库管理功能，所谓“快速安装数据库管理端”，实际是通过插件 + 外部工具组合实现的轻量级本地数据库操作。直接装个插件不会自动给你弹出 GUI 界面，必须配好命令行客户端或 GUI 工具路径，否则 SQLTools 连 mysql 命令都找不到，执行查询会报 'mysql' is not recognized as an internal or external command。
为什么 SQLTools 插件启动就报错？
根本原因是它不自带 MySQL 客户端，只调用系统 PATH 下的 mysql、mysqldump 等命令。常见失败点：
- MySQL 没装命令行客户端（只装了 Workbench 不够）
- MySQL 的
bin/目录没加进系统 PATH（Windows 要手动编辑环境变量；macOS/Linux 要在~/.zshrc或~/.bash_profile里加export PATH="/usr/local/mysql/bin:$PATH"） - PATH 配置后没重启 Sublime（改完 PATH 必须完全退出再重开）
- 插件设置里填了错误的
mysql_path，比如写成C:Program FilesMySQLMySQL Server 8.0inmysql.exe却漏了转义反斜杠，应写为C:\Program Files\MySQL\MySQL Server 8.0\bin\mysql.exe
SQLTools 用户配置怎么写才有效？
在 Sublime 的 Preferences → Package Settings → SQLTools → Settings – User 里，必须显式声明连接参数和路径。关键字段不是可选的：
-
"mysql_path"：指向mysql可执行文件（不是 Workbench），例如 Windows 下为"C:\Program Files\MySQL\MySQL Server 8.0\bin\mysql.exe" -
"connections"：至少定义一个连接对象，包含"host"、"port"、"user"、"password"、"database" - 密码为空时不能删掉
"password"字段，要写成"password": "" - 如果用 socket 连接（如 macOS MAMP），需设
"socket": "/Applications/MAMP/tmp/mysql/mysql.sock"，此时"host"和"port"会被忽略
示例片段（仅关键部分）：
{
"mysql_path": "C:\Program Files\MySQL\MySQL Server 8.0\bin\mysql.exe",
"connections": [
{
"key": "local",
"type": "mysql",
"host": "127.0.0.1",
"port": 3306,
"user": "root",
"password": "your_password",
"database": "test"
}
]
}
想一键打开 MySQL Workbench 怎么配？
这不是 SQLTools 的事，得用 Sublime 的 Build System 或快捷键绑定。Workbench 启动慢，别指望它像命令行那样秒响应 —— 它是独立 GUI 进程，Sublime 只负责发个调用指令。
- Build System 方式：新建
MySQLWorkbench.sublime-build，内容为：
{
"cmd": ["C:\Program Files\MySQL\MySQL Workbench 8.0 CE\mysqlworkbench.exe"],
"shell": true
}
- 快捷键方式（更推荐）：在
Preferences → Key Bindings – User加一条：
[
{
"keys": ["alt+m"],
"command": "exec",
"args": {
"cmd": ["C:\Program Files\MySQL\MySQL Workbench 8.0 CE\mysqlworkbench.exe"]
}
}
]
注意：shell 设为 true 才能处理空格路径；路径中所有反斜杠必须双写；Mac 上路径类似 /Applications/MySQLWorkbench.app/Contents/MacOS/mysqlworkbench，但需确保有执行权限（chmod +x）。
真正容易被忽略的是：SQLTools 的查询结果默认输出到 Sublime 底部面板，但这个面板不支持滚动条拖动、不保留历史、无法复制整块结果——它只是临时缓冲区。如果查出来的数据超过一屏，你得立刻按 Ctrl+A 全选复制，否则一关面板就丢了。这不是 bug，是设计如此。
