如何在VSCode中进行数据库连接与查询？【教程】

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(); 确认上下文。