VSCode需安装Database Client扩展连接数据库；它内置连接逻辑，支持多数据库，但MySQL 8.0+认证插件不兼容时需改用mysql_native_password或启用SSL；查询默认独立会话，变量与事务不共享，大结果集和CSV导出需注意限制。
VSCode 本身不内置数据库连接能力，必须依赖扩展；直接装 SQL Server Extensions 或 MySQL Support 这类名字的插件，大概率连不上——因为它们只是语法高亮或基础补全工具，不是真正的客户端。
用 Database Client 扩展连接主流数据库
目前最稳定、支持最全的是 Database Client（作者 ckolkman），支持 PostgreSQL、MySQL、SQLite、SQL Server、Oracle、MongoDB（通过 MongoDB Shell）等。它不依赖本地 CLI 工具（如 psql 或 mysql），所有连接逻辑在扩展内完成。
- 安装后按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Database: New Connection - 选择数据库类型 → 填写主机、端口、数据库名、用户名、密码（SSL 模式按需勾选）
- 连接成功后，左侧会新增
Database视图，可展开表、右键Query Table快速查数据 - 新建
.sql文件，编辑时自动识别当前活动连接，执行Ctrl+Enter即运行光标所在语句
MySQL 连接失败常见原因与绕过方式
即使填对了账号密码，也常因 MySQL 8.0+ 默认认证插件从 mysql_native_password 改为 caching_sha2_password 导致拒绝连接。
- 检查错误信息是否含
Client does not support authentication protocol—— 是则确认服务端用户认证方式 - 临时解决：用命令行登录 MySQL，执行
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass'; - 更安全做法：在 VSCode 连接配置中启用
SSL并指定 CA 文件路径（尤其对接云数据库时） - 若用本地
mysqld且端口非默认3306，务必核对bind-address是否监听127.0.0.1而非localhost（后者可能触发 socket 连接，扩展不支持）
执行查询时注意上下文隔离与事务行为
Database Client 默认每个查询都在独立会话中执行，不共享变量、不自动开启事务。这意味着：
-
SET @var = 1;后紧跟SELECT @var;—— 第二条会报错，因为变量未定义（会话已重置） -
BEGIN;+UPDATE+COMMIT;三行一起执行仍可能只提交前两行（取决于光标位置和执行方式），建议拆成单个查询块再运行 - 大结果集默认只取前 1000 行，可在设置里改
databaseclient.maxRows，但超过 10 万行易卡死 UI - 导出 CSV 时注意字段含换行符或逗号，扩展不会自动加引号，建议先导出为 JSON 再转换
真正麻烦的不是连上数据库，而是搞清「哪个扩展实际管连接」「哪类错误是服务端策略导致」「哪些 SQL 习以为常的写法在 VSCode 查询里根本不可用」——这些细节没文档明说，只能靠报错信息反推。
