怎么在VSCode里连接MySQL数据库-SQL管理插件安装教程

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 字段千万别空着。