VSCode需安装对应数据库扩展才能连接，MySQL、PostgreSQL、SQL Server扩展互不兼容，通用扩展需手动配置连接串；连接失败先查服务状态、权限、SSL设置及依赖模块；执行SQL前确认文件类型、语言模式、分号结尾和结果集限制。
VSCode 本身不内置数据库连接功能，必须依赖扩展；直接装 SQL Server 扩展连不了 MySQL，装 MySQL 扩展也打不开 PostgreSQL，选错扩展是初学者最常卡住的地方。
怎么选对数据库扩展？看协议和驱动类型
不同数据库用的通信协议和客户端驱动完全不同，扩展本质是调用对应 CLI 工具或 SDK 封装的 GUI 界面：
-
MySQL扩展（如vscode-mysql）依赖本地mysql命令行工具或内置 JS 驱动，只支持 MySQL / MariaDB -
PostgreSQL扩展（如PGSQL）基于node-postgres，不兼容 SQLite 或 SQL Server -
SQL Server扩展（如mssql）用tedious驱动，仅支持 TDS 协议（SQL Server、Azure SQL） - 通用型扩展如
Database Client支持多类型，但需手动配置 JDBC URL 或连接字符串，容易填错host、port、database
连接失败常见报错和对应解法
看到报错别急着重装扩展，先查日志和网络层：
-
Failed to connect: Connection refused→ 检查数据库服务是否运行（systemctl status mysql或brew services list），端口是否被防火墙拦截 -
Access denied for user 'xxx'@'localhost'→ 用户权限未授权远程访问，执行GRANT ALL ON *.* TO 'xxx'@'%' IDENTIFIED BY 'pwd'; FLUSH PRIVILEGES; -
SSL connection is required（PostgreSQL/MySQL 8.0+）→ 在扩展连接配置里把ssl设为require或disable（开发环境可关） -
Cannot find module 'pg'→ 扩展依赖未自动安装，尝试在 VSCode 终端运行npm install pg（仅限部分扩展）
写查询时怎么避免“执行没反应”？
很多扩展默认不自动提交事务或不启用结果集自动渲染，导致你点了运行却看不到数据：
- 确认当前打开的是
.sql文件，且右下角语言模式显示为SQL（不是Plain Text） - 检查扩展设置里是否启用了
Run query in editor（有些扩展需右键选择“Execute Query”，而非 Ctrl+Enter） - MySQL 扩展中，如果语句末尾没加分号
;，可能只执行前半句或静默失败 - 大结果集默认限制 1000 行，查不到数据可能是被截断了，在扩展设置里调高
maxRows
真正麻烦的不是连不上，而是连上了却用错隔离级别、忘设时区、或把 SELECT 当成 UPDATE 运行——这些不会报错，但数据就变了。连上之后第一件事，先跑 SELECT version(), current_database(), now(); 确认上下文。
