更新记录

0.6.2（2026-11-06） 下载此版本

• 连接管理：新建 / 编辑 / 删除 / 测试连接，配置本地持久化；密码 AES-256-GCM 加密保存（可关闭），磁盘无明文；数据库名可留空，先连实例再切换当前库
• 结构浏览：库 → 表 / 视图 / 函数 / 存储过程 / 事件 / 触发器六类分组；手风琴展开、默认全折叠；右键生成 CREATE 模板、查看定义、复制名称
• SQL 工作台：关键词 / 表名 / 列名补全与 sel / del / ins / upd / joi 片段、SQL 格式化、查询历史、参数化查询
• 查询执行：执行当前语句（Ctrl/Cmd + Enter）、执行全部语句（Ctrl/Cmd + Shift + Enter，结果按 Result1 / Result2 … 分标签）
• 可编辑结果网格：修改 / 增加 / 删除 / 提交 / 刷新 / 停止六个按钮；单元格单击编辑、暂存着色、提交前逐条 SQL 预览、单事务执行失败整体回滚、主键精确定位
• 报表与导出：列画像报表（去重值 / NULL 占比 / min / max / avg）、CSV 导出、结构 + 数据逻辑备份
• 隐私：不收集、不上传任何使用数据或连接信息；写入语句全部参数化

平台兼容性

HBuilderX Database —— 数据库客户端插件

在 HBuilderX 里直接连接并操作 MySQL / MariaDB、PostgreSQL、SQLite：左侧结构树浏览库与对象，右侧 SQL 工作台写查询、看结果、改数据、导出与备份。

功能

• 连接管理：新建 / 编辑 / 删除 / 测试连接，密码 AES-256-GCM 加密保存（可选），重启免重输
• 结构浏览：连接 → 库 → 表 / 视图 / 函数 / 存储过程 / 事件 / 触发器，六类分组；双击库名切换当前库
• SQL 工作台：关键词 / 表名 / 列名补全、sel/del/ins/upd/joi 片段、格式化、查询历史、执行当前语句、执行全部语句（结果按 Result1 / Result2 … 分标签）
• 结果网格：排序、复制单元格、单击修改 / 增加 / 删除 / 提交 / 刷新 / 停止；提交前逐条预览 SQL，事务执行，失败整体回滚
• 右键新建对象：库 / 分组 / 对象上右键按方言生成 CREATE 模板（不自动执行）
• 导出与报表：CSV 导出、查询结果列画像报表、结构 + 数据逻辑备份（生成 .sql）
• 系统库开关：hxdb.showSystemDatabases 控制是否显示 MySQL 系统库

安装

• 插件市场安装：在 ext.dcloud.net.cn 详情页点「安装到 HBuilderX」
• 离线安装：把本 zip 解压到 HBuilderX 安装目录的 plugins/ 下，重启 HBuilderX

要求 HBuilderX ≥ 2.8.1（清单 engines.HBuilderX: ^2.8.1）。插件依赖已随包分发，无需执行 npm install。

快速开始

1. 打开「视图 → 显示扩展视图」，或按 Ctrl+Alt+D 打开 SQL 工作台
2. 点「新建连接」，选择数据库类型，填写主机 / 端口 / 用户名 / 密码 / 数据库（数据库可留空），保存
3. 左侧展开库 → 展开「表」 → 点表名，自动生成查询；或在编辑器写 SQL
4. Ctrl/Cmd+Enter 执行当前语句，Ctrl/Cmd+Shift+Enter 执行全部
5. 结果区默认可编辑，改完点「提交」，确认预览后写入

支持数据库与驱动

配置项

安全提示

• 密码加密密钥与密文都在本机 data/ 目录，请勿把 data/ 提交到代码仓库
• 连接生产库建议使用只读账号；「停止」按钮只释放界面并丢弃结果，不会强制终止服务端语句
• 行内编辑只支持单表简单 SELECT（JOIN / 聚合 / 子查询等只读）；无主键表的 UPDATE / DELETE 可能命中重复行，提交前请看预览
• 内置备份为逻辑备份（DDL + INSERT），生产环境建议使用 mysqldump / pg_dump

开源与许可

架构与纯逻辑参考了两个 MIT 开源项目（详见包内 THIRD-PARTY-NOTICES.md）：

• mtxr/vscode-sqltools（MIT，© Matheus Teixeira / George James Software）
• cweijan/vscode-database-client 4.7.0 早期源码（MIT；新版已闭源，未使用）

插件代码按 HBuilderX 扩展规范重写，未复制上述项目的源码文件。运行时依赖 mysql2 / pg / sql.js / Vue 3 均为 MIT。

已知边界

MySQL / PostgreSQL 的真实实例链路未在开发环境全程验证，建议先拿测试库跑一次 SELECT 1；Monaco 语法高亮、SSH 隧道、Redis / ClickHouse 等非关系型、可视化建表向导尚未实现。