VSCode需安装对应数据库专用扩展才能连接，无万能插件；配置须严格匹配协议/端口/大小写等格式，执行前需设置正确语言模式并注意写操作默认禁用；复杂场景建议切换专业工具。
VSCode 本身不内置数据库连接功能，必须依赖扩展；直接装官方 SQL Server 或 MySQL 扩展只能连对应数据库，跨库查询或执行 DDL/DML 需要额外配置或换工具。
安装支持目标数据库的专用扩展
不同数据库协议差异大，没有“万能插件”。常见选择：
-
MySQL：装MySQL（by cweijan）或vscode-mysql（by oriceon），前者支持连接池和简单可视化，后者轻量但只支持基础查询 -
PostgreSQL：用PostgreSQL（by Chris Kolkman），它依赖本地psql命令行工具，没装会报Command 'psql' not found -
SQLite：SQLite Viewer（by qwtel）可直接打开.db文件，但不支持写操作；需要执行 SQL 请换SQLite Explorer -
SQL Server：微软官方mssql扩展，需启用SQL Server Authentication或配置 Windows 集成认证，连 Azure 时容易卡在Login failed for user
配置连接字符串时注意协议与端口细节
很多连不上是因为填了图形界面里“习惯性”的值，但扩展实际要求严格格式。例如：
- MySQL 连接中，
host不能写localhost:3306，得拆成host: localhost+port: 3306，否则报getaddrinfo ENOTFOUND localhost:3306 - PostgreSQL 的
database字段必须存在且大小写敏感，填错会提示database "xxx" does not exist，而默认库名通常是postgres - SQL Server 的
server字段若指向 Azure，必须带后缀，如xxx.database.windows.net，漏掉.database.windows.net会超时
执行查询前先确认文件关联与语言模式
VSCode 不会自动识别 .sql 文件该用哪个扩展执行。常见问题：
- 右下角状态栏显示
Plain Text→ 点击它，选SQL（或对应方言如MySQL），否则语法高亮失效，部分扩展的执行按钮也不出现 - 多个 SQL 扩展共存时（比如同时装了 MySQL 和 PostgreSQL），执行快捷键
Ctrl+Shift+P→Run Current Query可能调用错引擎，建议在连接成功后，从侧边栏数据库节点右键执行，而非用全局命令 - 写完
INSERT或UPDATE后没反应？检查扩展是否默认禁用写操作——MySQL扩展需在设置里开启mysql.confirmExecuteUpdate并设为false，否则静默失败
临时查数据别硬扛，该切就切
VSCode 的 SQL 扩展适合轻量查询、结构浏览和脚本调试，但遇到以下情况，及时切到专业工具更省时间：
- 需要导出百万行 CSV —— VSCode 会卡死或截断，用
mysqldump/pg_dump命令更稳 - 想看执行计划（
EXPLAIN结果）带可视化树图 ——DBeaver或DataGrip支持折叠/高亮，VSCode 扩展只返回纯文本 - 频繁切换多个环境（dev/staging/prod）且连接参数复杂（如 SSH 隧道、IAM token）—— 扩展配置项有限，不如写个
.env+sqlxCLI 脚本灵活
真正卡住的往往不是“怎么连”，而是连上之后发现扩展根本不处理你手头这个特定版本、特定认证方式、特定网络拓扑下的连接请求——先看错误信息里有没有 SSL、authentication、timeout 这类关键词，再决定是调参数、换扩展，还是绕开 VSCode。
