应安装 Database Client(作者 cweijan),它原生支持 MySQL 5.7~8.4 及 caching_sha2_password 认证,填完 host/port/user/password/database 四项必填参数即可测试连接,无需额外驱动或服务端配置。

VSCode 本身不支持直连 MySQL,必须靠扩展;当前最省心、适配性最强的方案是装 Database Client(作者 cweijan),它原生支持 MySQL 5.7~8.4,包括默认的 caching_sha2_password 认证,填完参数就能测通,不用额外装驱动、也不用改服务端配置。
该装哪个插件?别被名字骗了
只装一个:搜索并安装 Database Client(作者 cweijan,图标是蓝色数据库+闪电)。它不是语法高亮插件,而是真能连、能查、能刷新结构树的客户端。
- 卸载所有带 “syntax”、“highlight”、“formatter” 的插件,它们只负责颜色,不处理连接
- 别装
SQLTools+ 驱动组合——除非你同时要管 PostgreSQL 和 SQLite;它依赖 Node.js 运行时,新手常卡在驱动没加载、VSCode 没重启、日志只报Connection refused却实际是驱动缺失 - 旧版
vscode-mysql已停更,不兼容 MySQL 8+,看到Client does not support authentication protocol就说明踩坑了
连接参数怎么填?四个字段不能空
点击侧边栏 Database 图标 → + → 选 MySQL,以下字段必须填且不能错:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
-
Host:本地开发填127.0.0.1(比localhost更稳,避免 socket 路径干扰);Docker 填host.docker.internal(macOS/Windows)或宿主机 IP(Linux);M1 Mac 若 MySQL 跑在 Rosetta 下,也建议用127.0.0.1 -
Port:显式写上3306,别省略;若 Docker 映射到3307,就填3307 -
Password:即使密码为空,也要留一个空格或删掉该字段(部分版本留空会静默失败);含@、/等字符需 URL 编码,如my@pwd→my%40pwd -
Database:必须填具体库名(如myapp_dev),留空会导致执行SELECT * FROM users;直接报错Table 'users' doesn't exist
连上了但查不出结果?连接上下文没激活
成功保存连接 ≠ 当前 SQL 文件已绑定该连接。Database Client 不自动继承上下文,得手动触发一次:
- 新建一个
query.sql文件,哪怕只写SELECT 1; - 右键编辑器 → 选
Run Query in MySQL(或按Ctrl+Shift+P输入该命令) - 首次运行会弹出连接选择框,选你刚配的那个;之后右下角状态栏才显示连接名(如
myapp_dev@127.0.0.1) - 如果状态栏没显示连接名,所有查询都静默失败——不报错、不出结果、也不提示
为什么测试连接成功,执行 SELECT 却报 No database selected?
这不是插件 bug,是 MySQL 协议行为:连接建立后默认不进入任何 schema,Database 字段只是“预设”,不等于自动 USE。解决方式只有两个:
- 建连接时务必填对
Database字段,并重新添加该连接(不是刷新) - 临时补救:先执行
USE myapp_dev;,再跑其他语句;右键已连接节点 →Change Database也可切换,但新查询仍走上次选定的库
注意:Database Client 对中文表名/字段名无自动补全,写 SELECT * FROM 用户表; 时不会提示列名,得靠自己记或查结构树。

















