vscode中无真正同款dbeaver扩展，因其是独立桌面应用；所谓“同款功能”实指连接管理、参数化查询等高频操作，仅sqltools配合官方驱动可接近该体验，而dbeaver extension仅为本地dbeaver启动器包装，无法内联查看结果、不支持连接上下文感知、需手动connect且不保存状态。
VSCode 里没有真正“同款 DBeaver”的扩展——DBeaver 是独立桌面应用，功能深度和稳定性远超任何 VSCode 插件；所谓“同款功能”，实际是指：在编辑器内完成连接管理、参数化查询、结果表格化、导出、多库切换等高频操作。能接近这一体验的，只有 SQLTools（配合官方驱动），不是 Database Client，也不是已弃用的 mssql 或泛用型“Database Client”插件。
为什么不能直接装 DBeaver Extension？
DBeaver 官方提供的 DBeaver Extension 本质是 VSCode 启动器包装，它调用本地安装的 DBeaver 桌面程序，并不把数据库能力嵌入编辑器。你写完 SQL，它会生成临时文件再唤起 DBeaver 窗口执行——这意味着：无法内联查看结果、不能右键执行选中语句、不支持连接上下文感知、导出要跳转到另一个 UI。它适合“偶尔发一查”，不适合日常 SQL 开发。
- 它不保存连接状态，每次执行都得重新加载 DBeaver 界面
- 无法在 VSCode 中显示查询耗时、影响行数、字段类型等元数据
- 若 DBeaver 未安装或版本太低（如低于 24.0），扩展直接报错
Command 'DBeaver: Execute SQL' resulted in an error
SQLTools + 驱动才是最接近 DBeaver 工作流的组合
SQLTools 本身不连库，必须搭配对应驱动插件（如 SQLTools PostgreSQL Driver），二者缺一不可。装错驱动作者（比如搜到“SQLTools MySQL Driver for VSCode”但作者不是 mtxr），大概率在连接云数据库或启用 SSL 时握手失败，错误信息为 Protocol error: unrecognized message type 或静默无响应。
- 连接配置走
~/.sqltools/connections.json（Linux/macOS）或%USERPROFILE%\.sqltools\connections.json（Windows），不是图形表单——手动编辑易丢引号或逗号，建议始终用命令面板：Ctrl+Shift+P→SQLTools: New Connection - PostgreSQL 连云服务（如 Supabase）必须设
"ssl": "require"，否则超时；MySQL 8+ 默认 require SSL，漏配会报Authentication plugin 'caching_sha2_password' cannot be loaded - 密码含
@、/、:等字符，必须 URL 编码，例如pa@ss/word→pa%40ss%2Fword，否则解析连接串失败
执行查询前必须手动 Connect，否则全是假成功
配置写进 connections.json ≠ 连上了。VSCode 不自动重连，也不缓存连接状态。重启、换工作区、甚至切个 Git 分支后，连接图标都是灰色的。常见错误 No active connection found 90% 是因为没点 Connect，而不是配置错。
- 右键连接名 →
Connect，看到绿色圆点且状态栏显示连接名才算活的 - 一个
.sql文件可混用多个连接：选中某段语句 → 右键 →Run Current Statement in Connection，不依赖全局选中的连接 - 想快速验证是否真通？右键任意表 →
Select Top 100 Rows，比手写SELECT *更快，也避开大表卡死 UI
结果乱码、字段名变 col_0、导出 CSV 失败？先看 clientEncoding 和 resultsLimit
中文字段名消失、值显示为 ???，不是字体问题，而是驱动未正确传递编码信息。PostgreSQL 需显式加 "clientEncoding": "UTF8"；MySQL 要确认服务端 character_set_client 和 collation_connection 是 utf8mb4。
- 字段名丢失（只显示
col_0,col_1）说明驱动未返回 column metadata，换最新版驱动，或终端跑psql -h host -U user -d db -c "\dt"看服务端是否正常响应 - 导出 CSV 默认只导当前页（
resultsLimit默认 1000 行），查大表记得先改配置："resultsLimit": 10000，否则导出为空或截断 - 执行长查询卡住？SQLTools 默认无 timeout，加
"timeout": 30（单位秒）防挂死
真正的难点从来不在“怎么点开连接面板”，而在于：host 填的是 localhost 还是 host.docker.internal，SSL 是 disable 还是 verify-full，密码有没有 URL 编码，以及——你有没有真的右键点了 Connect。
