VSCode需安装扩展才能连接数据库，推荐Database Client；配置时注意URI格式、特殊字符编码及认证方式；执行SQL需分号分隔多语句，结果以表格展示但有行数限制。

VSCode 本身不内置数据库连接能力，必须依赖扩展；直接装插件、配连接字符串、连不上基本都是配置或驱动问题。

安装支持 SQL 的数据库扩展

官方推荐用 SQL Server (mssql)（微软自家）、MySQL Support（cweijan）、Database Client（cptx86）这类通用型扩展。其中 Database Client 支持 MySQL、PostgreSQL、SQLite、SQL Server、Oracle 等，且无需本地安装 CLI 工具，适合多数人起步。

• 在 VSCode 扩展市场搜 Database Client，安装后重启窗口
• 避免装多个同类扩展，容易冲突（比如同时启用 MySQL Support 和 Database Client 可能导致右键菜单异常）
• 某些扩展（如旧版 SQLTools）已停止维护，连接 PostgreSQL 时可能报 pg.connect is not a function，应换用活跃项目

配置数据库连接信息（以 PostgreSQL 为例）

连接失败最常见原因是 URL 格式不对或认证方式不匹配。PostgreSQL 默认使用 postgres:// 协议，但部分扩展只认 postgresql://；密码含特殊字符（如 @、/）必须 URL 编码。

• 点击侧边栏数据库图标 → “+” → 选择数据库类型 → 填写 Host、Port、User、Password、Database
• 若手动编辑连接 URI，请用 postgresql://user:pass%40word@localhost:5432/mydb 格式（注意 @ 编码为 %40）
• 本地 PostgreSQL 若启用了 peer 认证（Linux/macOS 默认），需改用 trust 或 md5 并重启服务，否则插件会卡在“Connecting…”

执行 SQL 查询与查看结果

扩展加载成功后，打开任意 .sql 文件，选中语句按 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS）即可执行。结果默认以表格形式展示，但有几点限制要注意：

• 多语句必须用分号 ; 分隔，否则只执行第一段（

  

  例如 SELECT 1; SELECT 2; 可以，SELECT 1\nSELECT 2 不行）
• DDL 语句（如 CREATE TABLE）执行后不会返回结果集，但错误会显示在输出面板（快捷键 Ctrl+Shift+U）
• 大结果集（>1000 行）可能被截断，可在扩展设置里调高 database-client.maxRows

常见报错与绕过方式

连得上但查不了，大概率是权限或协议问题。比如 MySQL 报 Client does not support authentication protocol，说明服务端用了 caching_sha2_password 插件，而插件底层驱动不兼容。

• MySQL 8.0+ 用户可临时降级认证：运行 ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'pass';
• SQLite 连接路径必须是绝对路径，相对路径（如 ./data.db）会提示 Unable to open database file
• 连接 SQL Server 时若提示 Failed to connect to server，检查是否启用了 TCP/IP 协议（SQL Server 配置管理器 → 协议 → 启用 TCP/IP）

数据库连接看似简单，但每个环节都卡在细节：URI 编码、认证方式、驱动版本、网络策略。建议先用 psql 或 mysql -u 命令行确认能通，再迁移到 VSCode，否则容易把环境问题误判成插件问题。