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）即可执行。结果默认以表格形式展示，但有几点限制要注意：
集企业自助建站、网络营销、商品推广于一体的系统 功能说明： 1、系统采用Microsoft SQL Server大型数据库支持，查询数据库用的全是存储过程，速度和性能极好。开发环境是vs.net，采用4层结构，具有很好的可维护性和可扩冲性。 2、用户注册和登陆 未注册用户只具备浏览商品、新闻和留言功能；要采购商品，需接受服务协议并填写相关注册信息成为正式用户后方可进行，以尽可能减少和避免无效
- 多语句必须用分号
;分隔，否则只执行第一段（例如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，否则容易把环境问题误判成插件问题。
