VS Code需装扩展连数据库，SQLTools最稳但须配驱动；配置时host、port、database、authenticationType四字段必核对；执行SQL需.sql文件、语言设为SQL、注意分号分隔；大结果导出等高级功能仍需专用客户端。

VS Code 本身不内置数据库客户端功能，必须通过扩展实现连接与操作；直接装插件不配置连接参数或忽略驱动兼容性，大概率连不上、查不出、甚至报 Connection refused 或 Driver not found 错误。

安装支持目标数据库的官方/高星扩展

不同数据库协议差异大，不能靠“通用SQL插件”一劳永逸。比如 PostgreSQL 要用 vscode-postgresql，MySQL/MariaDB 推荐 SQLTools（配合 SQLTools MySQL/MariaDB Driver），SQLite 可直接用内置 SQLite Explorer 扩展。

• SQLTools 是目前对多数据库支持最稳的，但必须单独安装对应驱动——只装主扩展不装驱动，连接时会提示 No driver found for mysql
• Microsoft 官方的 mssql 扩展仅支持 SQL Server，不支持 Azure SQL 的部分新认证方式（如 Microsoft Entra ID 多重验证），需改用 SQLTools + SQLTools MSSQL Driver
• 避免使用已停更的插件（如旧版 Database Client），其不兼容 VS Code 1.80+ 的 API，连接后执行查询常卡死或返回空结果

配置连接时必须核对的 4 个关键字段

在 SQLTools 的连接配置中，host、port、database、authenticationType 这四项填错任意一个，都会导致连接失败，且错误提示往往模糊（例如只显示 Failed to connect）。

• host 填 localhost 时，实际走的是 IPv6 回环（::1），而某些本地数据库（如 Docker 启动的 MySQL）默认只监听 IPv4（127.0.0.1）——此时应改填 127.0.0.1
• port 别盲目填默认值：PostgreSQL 常是 5432，MySQL 是 3306，但 Docker 容器或云数据库可能映射到其他端口，必须查实
• database 字段不能为空（即使想连上后手动选库），否则连接成功但无法展开 schema，执行 SELECT * FROM users; 会报 unknown database
• 使用密码认证时，authenticationType 必须设为 Basic；若数据库启用了 SSL，还要打开 ssl 开关并指定 sslCertificate 路径，否则握手失败

执行 SQL

时容易被忽略的上下文约束

SQLTools 等插件不是独立客户端，它复用 VS Code 的编辑器上下文，因此执行行为受当前文件类型、光标位置和选区影响，不是“随便点一下就能跑”。

• 文件必须保存为 .sql 后缀，且语言模式设为 SQL（右下角点击切换），否则右键菜单不显示 Execute Query
• 光标在语句内无选区时，插件默认执行“当前语句”——但它的分隔逻辑是分号 ;，不是换行；如果写成多行无分号的语句（如 CTE 后直接跟 SELECT），会被截断执行
• 选中某段再执行，才真正运行所选内容；但若选区跨文件、含注释块或包含未闭合引号，可能触发语法解析异常，报错信息是 Unexpected token 而非数据库原生错误
• 结果以只读表格形式展示，双击单元格不能编辑；如需更新数据，必须写 UPDATE 语句并手动执行——没有可视化编辑行的功能

真正的难点不在“连上”，而在连上之后识别出哪些操作是插件支持的、哪些必须切回命令行或专用客户端。比如导出大结果集（>10 万行）、执行存储过程带输出参数、调试函数逻辑——这些目前都没有稳定可靠的 VS Code 插件方案，别硬扛。