Database Client：纯 MySQL 日常开发最省心的选择
Database Client 是纯 MySQL 日常开发最省心的选择，因其原生支持 MySQL 5.7～8.4（含 caching_sha2_password）、无需额外驱动、填完 host/port/user/password/database 即可测试连接，且支持右键生成语句、实时刷新结构树等高效功能。
如果你主要和 MySQL 打交道，那么直接连接 MySQL 就行，没必要去折腾 SQLTools 主扩展加驱动那种组合——除非你确实需要同时管理 PostgreSQL 或 SQLite。对于纯粹的 MySQL 日常开发，无论是查询数据、修改字段还是跑迁移脚本，Database Client（作者 cweijan）可以说是当前最省心的选择：填好 host、port、user、password、database 这几项，点一下“测试连接”就能搞定。它不会弹出 Ja va 错误，不会卡在 “Connecting…”，更不会报恼人的 Client does not support authentication protocol。
为什么 Database Client 比 SQLTools 更适合单 MySQL 场景
SQLTools 的设计更像一个平台型插件，本身不带任何数据库驱动，这意味着你必须额外安装 SQLTools MySQL Driver 才能连接 MySQL。但这个过程往往暗藏玄机：一不小心搜错驱动名字（比如装成 MySQL Connector/NET）、忘记重启 VS Code，或者驱动根本没被启用，都可能导致连接失败。更麻烦的是，日志往往只显示一个笼统的 Connection refused，真正的问题——驱动没加载——反而被掩盖了。
Database Client 的思路则完全不同。它原生就打包了对 MySQL 5.7 到 8.4 版本的支持，连默认的 caching_sha2_password 认证方式都考虑到了。它不依赖 Ja va 或任何额外的二进制文件，连接表单直接填写，省去了手动编辑 connections.json 或 config.json 的麻烦。
- 它支持右键点击表名，直接选择
Generate SELECT statement，生成一条可编辑的查询语句，有效避免了手敲表名可能出现的拼写错误。 - 侧边栏直接展示清晰的库→表→列结构树，双击字段还能查看注释，信息一目了然。
- 执行建表、加索引、改字段类型等 DDL 操作后，结构树会立刻自动刷新，无需手动点击刷新按钮。
Database Client 连接 MySQL 必填的四个参数
安装好插件后，点击侧边栏的 Database 图标，选择 + Add Connection，然后选中 MySQL。以下几个字段是关键，绝对不能空着或填错：
Host：本地 MySQL 填localhost；如果是 Docker 容器，macOS/Windows 用户填host.docker.internal，Linux 用户则填宿主机的 IP 地址。Port：默认是3306；如果 Docker 将端口映射到了3307，这里就填3307，注意填的是宿主机的映射端口，不是容器内部的端口。Password：必须填写，即使你的数据库用户密码为空——留空会导致静默失败，不报错但也连不上。Database：必须填写具体的库名（例如myapp_dev）。如果留空，后续执行类似SELECT * FROM users的查询时，会直接报错Table 'users' doesn't exist。
至于其他字段，比如 SSL、Connection timeout，保持默认即可；charset 实际上插件会自动设为 utf8mb4，无需手动干预。
常见连不上原因和对应解法
连接失败的问题，基本可以归为三类：认证失败、网络不通、权限不足。遇到问题先别急着重装插件，看清楚错误信息再动手，往往事半功倍：
- 如果报错
Client does not support authentication protocol：这通常说明你用的是 MySQL 8+ 版本，并且启用了caching_sha2_password认证，而你安装的可能是老旧插件（比如vscode-mysql）。卸载旧插件，换上Database Client就能解决。 - 如果报错
Access denied for user 'root'@'127.0.0.1'：检查一下 MySQL 用户是否允许从本地连接。用命令行运行mysql -u root -p能进去，不代表 VS Code 就能连上。需要确认用户是'root'@'localhost'或'root'@'%'，而不是'root'@'127.0.0.1'。 - 如果报错
Connection refused：首先确认 MySQL 服务是否在运行（可以执行sudo service mysql status查看），然后检查bind-address是否设置为0.0.0.0（而不是127.0.0.1）。使用 Docker 的用户要特别注意宿主机的端口映射是否生效（运行docker ps查看 PORTS 列）。
执行 SQL 后看不到结果？先看右下角状态栏
连接成功，并不等于查询会自动执行。很多用户写完 SELECT * FROM users; 后右键点击却没反应，问题往往出在没有绑定连接上下文：
- 新建一个
.sql文件并保存后，留意右下角状态栏，应该会显示类似MySQL: myapp_dev的标识。如果没有显示，说明当前文件还没有关联到任何数据库连接。 - 这时，可以在编辑器里右键，选择
Change Connection，然后选中你刚刚配置好的那个连接。 - 或者，也可以把光标放在 SQL 语句中，按下
Ctrl+Shift+P，输入Database Client: Execute Query，然后手动选择连接。 - 查询结果默认会在下方的
Database Client Results面板中以表格形式展示，支持复制整列数据、导出为 CSV 文件。不过，它不支持点击结果直接跳转到对应的表结构页，这个习惯需要适应一下。
这里有个真正容易被忽略的细节：如果在最初配置连接时没有填写 Database 字段，那么后续所有的查询都会默认在“无库”的上下文中执行。即使你通过右键表名生成的语句，也不会自动带上库前缀，而 USE xxx; 语句又不会持久生效。所以，第一次配置连接时，Database 字段千万别空着。
