VS Code需安装匹配数据库类型的专用扩展才能连接数据库，通用插件无效；配置时须注意协议、SSL、密码编码、路径及连接验证等细节，否则易报错或连不上。
VS Code 本身不内置数据库连接功能，必须依赖扩展；直接装插件就能连上是常见误解，实际需要明确数据库类型、驱动支持和认证方式三者匹配。
安装对应数据库的官方或高星扩展
不同数据库协议差异大，不能靠“通用SQL插件”一劳永逸。比如 PostgreSQL 要用 PostgreSQL（by Chris Kolkman），MySQL/MariaDB 推荐 MySQL|MariaDB（by cweijan），SQLite 直接用内置支持或 SQLite Viewer。SQL Server 用户得选 mssql（Microsoft 官方）。装错扩展会导致连接时卡在“Connecting…”或报 Protocol error: unrecognized message type。
- 确认扩展是否仍在维护：看 GitHub 最后更新时间、issue 响应频率
- 避免装“Database Client”类泛用插件——它们常缺事务控制、参数化查询或 SSL 配置项
- 部分扩展（如
mssql）需额外安装sqltoolsserviceCLI 工具，否则执行查询会提示Command 'MSSQL: New Query' resulted in an error
配置连接信息时注意字段语义和默认值陷阱
很多用户填了 host 和 port 就以为够了，结果连不上。以 PostgreSQL 为例：host 不能写 localhost 当本地 Unix socket 用（除非显式启用 TCP），而应填 127.0.0.1；database 字段为空会连到默认库（通常是同用户名的库），但多数生产环境禁用该库，导致 connection refused；ssl 默认为 disable，但云数据库（如 AWS RDS、Supabase）强制要求 require 或 verify-full，漏配就超时。
- 密码含特殊字符（如
@、/）必须 URL 编码，否则解析连接串失败 - MySQL 扩展里
server字段实际等价于host，但有些插件把server当作别名处理，填错位置会静默忽略 - SQLite 连接路径必须是绝对路径，相对路径从 VS Code 启动目录算起，不是文件所在目录
执行查询前先验证连接状态和上下文
点击扩展侧边栏的“+”新建连接后，VS Code 不会自动测试连通性。必须手动右键连接项选 Connect，看到状态栏显示数据库图标变绿才算成功。此时打开 .sql 文件，右上角出现数据库选择下拉框——这个下拉框决定当前查询发往哪个连接，而非文件路径或文件名。如果误选了未连接的条目，执行会报 No active connection found，而不是连接超时。
- 一个 SQL 文件可跨多个连接执行：选中某段语句 → 右键 →
Run Current Statement in Connection，不依赖全局选中的连接 - 参数化查询（如
SELECT * FROM users WHERE id = $1）仅部分扩展支持（PostgreSQL插件支持，MySQL插件不支持），硬写?或:id会当字面量执行 - 结果表格双击单元格无法编辑，这是只读视图；要改数据得用扩展提供的“Edit Data”功能（如有），或手写
UPDATE
最易被忽略的是连接复用机制：关闭 VS Code 后连接不会自动断开，下次启动可能沿用旧凭据或过期 token，尤其在使用 OAuth 或临时凭证（如 AWS IAM auth）时，务必手动右键连接项点 Disconnect 再重连。
