VS Code数据库插件需按具体名称搜索，如SQLTools、Shield CLI PostgreSQL等，避免使用“数据库管理”等模糊关键词；安装后若无图标，需重载窗口并确认活动栏启用；连接失败多因驱动缺失或配置错误。
直接搜插件名，别信“数据库管理”这类模糊关键词
VS Code 扩展市场里没有统一叫“数据库插件”的东西，搜这个只会出来一堆不相关或已废弃的扩展。真正能用的都是按数据库类型或功能命名的，比如 SQLTools、vscode-database-client、Shield CLI PostgreSQL、SQLite。你得先明确自己要连什么——MySQL？PostgreSQL？SQLite？还是多类型混用？再针对性搜索。
常见错误是搜“database”或“mysql plugin”，结果装了过时的 vscode-mysql（2020 年后基本不再维护），连接失败还查不出原因。
- MySQL 推荐用
SQLTools+ MySQL driver，或vscode-database-client - PostgreSQL 优先选
Shield CLI PostgreSQL或SQLTools - 本地轻量开发用 SQLite，直接搜
SQLite插件，安装即开箱可用 - 需要 SSH 隧道或多种协议支持，
SQLTools是目前兼容性最稳的选择
安装后没图标？检查是否启用并重载窗口
插件装完不显示图标，不是没装成功，而是 VS Code 没自动激活侧边栏面板。点左下角齿轮图标 → “Settings” → 搜索 workbench.activityBar.visible，确认为 true；再手动按 Ctrl+Shift+P 输入 Developer: Reload Window 重载一次。
有些插件（如 DBCode）装完不会立刻出现新图标，必须重启 VS Code 或重载窗口才生效。别急着卸载重试。
-
SQLTools安装后图标是数据库形状的蓝色方块，位置在活动栏最下方 -
vscode-database-client图标是“Database Explorer”，名称带空格，注意别漏掉 - 如果图标出现了但点击无响应，大概率是插件依赖没拉下来——看右下角状态栏有没有黄色提示“Installing drivers…”
连不上 MySQL？重点核对这三项配置
填完 Host、Port、Username、Password 却提示 Connection refused 或 Access denied，90% 是这三个地方错了：
- Host 填
localhost时，MySQL 默认只监听127.0.0.1；换成127.0.0.1或确认 MySQL 的bind-address允许localhost - Port 别默认填 3306 就完事——Docker 启的 MySQL 容器常用
3307，Homebrew 装的可能用8889，先netstat -an | grep mysql确认真实端口 - Password 字段留空 ≠ 不验证密码；某些插件（如老版
vscode-database）会把空密码当成 null 处理，导致认证失败；宁可填一个错密码看报错类型，再修正
驱动缺失或版本冲突，比连接配置更难排查
SQLTools 和 vscode-database-client 都依赖外部驱动程序（driver），不是纯前端插件。装完插件只是第一步，首次连接时它会自动下载对应驱动，但经常卡在“Downloading driver…” 或报 Failed to load driver: mysql2。
这时候不能只刷新插件页，得打开命令面板（Ctrl+Shift+P）运行 SQLTools: Show Output，看日志里具体卡在哪一步。常见情况：
- 网络问题导致 driver 下载失败：手动去
~/.sqltools/drivers/（macOS/Linux）或%USERPROFILE%\.sqltools\drivers\（Windows）删掉整个文件夹，重连触发重下 - Node.js 版本太高（比如 v20+），某些 driver 编译失败：降级到 Node.js v18 LTS，再重装插件
- 公司内网禁用了 GitHub raw URL：需手动下载 driver zip 包，解压后放到对应 drivers 目录下
驱动问题往往不报红字错误，只表现为“连接中…”然后静默超时，这点最容易被忽略。
