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 插件方案，别硬扛。
