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）需额外安装 sqltoolsservice CLI 工具，否则执行查询会提示 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 再重连。