VSCode需通过扩展实现数据库查询，推荐SQLTools（支持多数据库、带查询面板）、vscode-database-client（轻量仅MySQL/PostgreSQL）和DBeaver Extension（功能全但较重）；避坑弃用扩展、填准host/port/database/password参数、注意分号结尾、检查连接上下文、调整maxRows限制，并确保本地安装对应驱动。
VSCode 本身不内置数据库客户端，但可通过扩展实现连接与查询；关键不是“装一个客户端”，而是选对扩展、配好连接参数、避开权限和驱动陷阱。
哪些 VSCode 扩展真正支持执行 SQL 查询
别被名字误导——很多叫“Database”“SQL Tools”的扩展只提供语法高亮或基础连接，无法直接运行查询。实测稳定可用的有：
-
SQLTools（推荐）：支持 PostgreSQL、MySQL、SQLite、SQL Server、Oracle 等，自带查询面板和结果表格视图 -
vscode-database-client：轻量，专注 MySQL/PostgreSQL，界面简洁，但不支持 Oracle 或复杂认证方式 -
Red Hat's DBeaver Extension：本质是 DBeaver 的 VSCode 封装，功能全但启动慢、内存占用高
避免安装 SQL Server (mssql)（已弃用）、DB Tools（长期未更新，连接常超时）这类维护停滞的扩展。
连接 PostgreSQL/MySQL 时必填的关键参数
填错任意一项就会报 Connection refused、authentication failed 或空结果。以 SQLTools 为例：
-
host：本地 Docker 容器用localhost不一定通，得填host.docker.internal（macOS/Windows）或容器网络别名 -
port：PostgreSQL 默认5432，MySQL 默认3306，但 Docker 启动时若映射为-p 5433:5432，这里必须填5433 -
database：不能留空，哪怕想连到集群级（如postgres系统库），也得显式写上 -
password：若用 .env 文件管理密码，SQLTools不自动读取，需手动粘贴或启用其“Secure Storage”功能
执行查询后没返回结果？先检查这三处
常见现象：写完 SELECT * FROM users; 点运行，状态栏显示“Query executed”，但下方结果区空白或只有表头。
- 是否漏了分号？
SQLTools和vscode-database-client默认要求语句以;结尾，否则静默忽略 - 是否在错误的连接上下文中执行？右下角状态栏会显示当前激活的连接名（如
pg-local），点它可切换；若显示No active connection，查询实际没发出去 - 结果集是否过大被截断？
SQLTools默认限制1000行，在设置中搜sqltools.maxRows可调高，但超过 10 万行建议加LIMIT
SELECT id, name, created_at FROM orders WHERE status = 'pending' ORDER BY created_at DESC LIMIT 100;
驱动缺失是隐形杀手：Windows 连 PostgreSQL 报 Cannot find module 'pg'，是因为 SQLTools 需要你本地全局装 npm install -g pg；Mac M 系列连 MySQL 可能因 mysql2 二进制不兼容而卡住，得换用 Rosetta 终端重装驱动。
