VS Code需通过SQLTools扩展连接数据库，安装主扩展及对应驱动后，手动配置connections.json文件，连接成功方可执行SQL查询并查看结果。
VS Code 本身不内置数据库连接功能，必须依赖扩展；SQLTools 是目前最稳定、支持最广的方案，比 Database Client 或 SQL Server Extensions 更适合多数据库统一管理。
安装 SQLTools 及对应驱动
SQLTools 是一个插件平台，连接不同数据库需要额外安装对应驱动（Driver），不是装完主扩展就自动支持所有数据库。
- 在 VS Code 扩展市场搜索并安装
SQLTools（作者：mtxr） - 再安装对应数据库驱动，例如：
- PostgreSQL → 安装
SQLTools PostgreSQL Driver - MySQL / MariaDB → 安装
SQLTools MySQL/MariaDB Driver - SQLite → 安装
SQLTools SQLite Driver - SQL Server → 安装
SQLTools SQL Server Driver
- PostgreSQL → 安装
- 驱动必须与
SQLTools主体同时启用，缺一不可
配置 connection.json 连接信息
连接数据库靠的是 connections.json 配置文件，不是图形界面填表——手动编辑是常态，路径通常为：~/.sqltools/connections.json（Linux/macOS）或 %USERPROFILE%\.sqltools\connections.json（Windows）。
常见错误：复制示例后没改 host、database 或漏掉 port；PostgreSQL 默认端口 5432，MySQL 是 3306，SQL Server 是 1433，不写会连不上。
{
"connections": [
{
"name": "my-postgres",
"driver": "PostgreSQL",
"host": "localhost",
"port": 5432,
"database": "myapp_dev",
"username": "postgres",
"password": "dev123"
}
]
}
执行 SQL 查询与结果查看
连接成功后，在资源管理器侧边栏点击 SQLTools 图标，展开连接列表，右键选择 Connect。连接成功会有状态提示（如 “Connected to my-postgres”）。
- 新建
.sql文件，写查询语句，光标停在某句上按Ctrl+Shift+P→ 输入SQLTools: Run Current Statement（或快捷键Ctrl+Enter） - 结果以表格形式显示在下方
SQLTools Results面板，支持导出为 CSV - 注意：如果执行报错
Query failed: no connection found，说明当前没激活连接，需先右键连接名点Connect，不能只靠配置文件存在就认为已连上 - 对大表慎用
SELECT *，SQLTools默认不限制返回行数，可能卡死 UI
常见问题与绕过限制
某些场景下 SQLTools 行为不符合直觉，不是 bug，而是设计如此：
-
password不支持环境变量或密钥管理器，明文写在connections.json中 —— 生产环境务必避免，建议仅用于本地开发 - 不支持 SSH 隧道直连，若数据库在跳板机后，得先用
ssh -L做端口转发，再连localhost - 没有“自动补全字段名”功能（不像 DBeaver），但支持基础关键字高亮和括号匹配
- 切换连接后，之前打开的
.sql文件不会自动绑定新连接，需手动右键选择SQLTools: Set Connection for Current File
真正麻烦的从来不是连上，而是连上之后搞不清当前用的是哪个连接、查的是哪张表、结果有没有被 LIMIT 截断——这些都得靠你主动确认，而不是指望工具提醒。
