优先选sqltools+对应驱动或database client（cweijan版）：前者需手动安装兼容驱动并重启vscode，后者配置直白但postgresql须设"ssl":false；二者均不支持单体插件的停更、跨库缺失及认证协议不兼容问题。
别装“MySQL”或“PostgreSQL”单体插件——它们要么停更、要么不跨库、要么认证协议不兼容，直接导致连不上、没提示、查不了执行计划。优先选 SQLTools + 对应驱动，或 Database Client（cweijan 版），二者覆盖 95% 的本地开发场景，且配置路径清晰、报错可定位。
SQLTools 必须手动装驱动，否则连接界面里选不到数据库类型
安装 SQLTools 主插件后，它本身不带任何数据库协议实现。不装驱动 = 空壳，新建连接时下拉菜单里只有“SQLite”，其他选项全灰。
- PostgreSQL：必须额外安装
SQLTools PostgreSQL Driver（作者 mtxr） - MySQL：必须装
SQLTools MySQL/MariaDB Driver，不是“MySQL Connector/NET”或“vscode-mysql” - 装完驱动后必须重启 VSCode，否则日志只显示
Connection refused，实际是根本没加载驱动模块 - 驱动版本要对齐：2026 年稳定组合是
SQLTools v0.35+配v0.12+驱动；旧驱动可能不识别 MySQL 8.0+ 的caching_sha2_password
Database Client 连 PostgreSQL 时 SSL mode 必须显式关掉
PostgreSQL 默认启用 sslmode=require，但本地开发环境通常没配证书。现象是：点 Connect → 状态栏显示“已连接” → 1 秒后断开，控制台无错误，日志里只有模糊的 Connection closed。
- 解决方法是在连接 JSON 配置中加
"ssl": false（注意：这是Database Client的字段名） -
SQLTools则要求写"sslmode": "disable"，字段名不通用，不能照搬配置 - 若用 Docker 启的 PostgreSQL，确认容器启动时没强制开启
ssl=on；Mac 用户尤其注意，brew services start postgresql默认不启 SSL
MySQL 8.0+ 连接失败大概率是 authPlugin 不匹配
现象包括：输入密码后卡住、光标不动、或报错 Client does not support authentication protocol。这不是密码错，而是认证插件不兼容。
- MySQL 8.0 默认用
caching_sha2_password，但Database Client和多数SQLTools驱动只认mysql_native_password - 临时解法（仅限开发机）：
ALTER USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; - 或在连接配置中强制指定：
"authPlugin": "mysql_native_password"（SQLTools支持；Database Client不支持该字段，得改服务端） - Database Client 要求四个字段必须填全：
host、port、password、database；任一留空都会静默失败，连错误弹窗都不出
mssql 插件连 SQL Server 必须设 Encrypt=true 才能查执行计划
装了微软官方 mssql 插件，却点“Explain”没反应？八成是加密配置漏了。Azure SQL 或新版 SQL Server 强制 TLS，不启用加密就拿不到真实执行计划。
- 连接配置中必须含
"encrypt": true和"trustServerCertificate": false - 必须显式指定
"databaseName"，否则SELECT DB_NAME()返回master，表补全和执行计划都错位 - 用户账号需有
VIEW SERVER STATE权限，且 SQL Server ≥ 2016；2014 及更早只能靠SET STATISTICS XML ON手动查 - 查询语句里不能含
GO，否则插件解析失败；用分号分隔，或拆成单语句再执行
最易被忽略的是驱动与主插件的版本对齐，以及 SSL/encrypt 字段的命名差异——Database Client 用 ssl，SQLTools 用 sslmode，mssql 用 encrypt，三者不互通，抄配置前务必确认插件名。
