直接删除workbench.xmi是最有效重置方式,因其专控DBeaver界面布局、面板位置及工具栏状态,损坏后会导致空白界面或组件消失;而credentials-config.json和connections.json不受影响,密码与连接配置得以保留。

直接删 workbench.xmi 是最有效、最常被验证过的重置方式。其他“清理缓存”“重置透视图”等操作,要么不彻底,要么只解决局部问题。
为什么重置要找 workbench.xmi 而不是删整个配置目录
DBeaver 的界面布局、面板位置、工具栏可见性、编辑器标签页顺序等,全由 workbench.xmi 文件控制。它相当于 Eclipse RCP 框架的“UI 快照”,每次退出时自动保存。一旦这个文件损坏(比如崩溃退出、磁盘写入中断),下次启动就会卡在空白界面、面板消失、按钮灰显——而其他缓存或插件目录可能完全正常。
-
workbench.xmi位置固定,但路径因系统而异:
Windows:%APPDATA%\DBeaverData\workspace6\.metadata\.plugins\org.eclipse.e4.workbench\workbench.xmi
macOS:~/Library/DBeaverData/workspace6/.metadata/.plugins/org.eclipse.e4.workbench/workbench.xmi
Linux:~/.local/share/DBeaverData/workspace6/.metadata/.plugins/org.eclipse.e4.workbench/workbench.xmi - 别删
.metadata整个文件夹——里面还存着连接历史、SQL 执行日志等有用数据 - 删完
workbench.xmi后,DBeaver 会自动生成一份默认布局,不需要重启系统或重装
删了 workbench.xmi 还没恢复?检查这三处残留
有些情况光删 workbench.xmi 不够,因为 DBeaver 会从其他地方读取旧状态:
- 检查
dialog_settings.xml:路径同上,在org.eclipse.ui.workbench/子目录里。它保存对话框尺寸、最近打开的 SQL 编辑器标签等,异常时会导致向导窗口无法弹出 - 确认没有启用
-clean参数启动:如果快捷方式或终端命令里带了dbeaver -clean,会强制重载所有插件,反而干扰 UI 初始化;临时去掉再试 - 留意
perspective配置是否被硬编码:某些定制版 DBeaver 或企业部署包会把透视图写死在plugin_customization.ini里,该文件通常在安装目录根路径下
重置后连接和密码还在吗
在,只要你不碰 credentials-config.json 和 connections.json 这两个文件。
-
credentials-config.json存在%APPDATA%\DBeaverData\(Windows)或~/Library/DBeaverData/(macOS)下,负责加密存储密码 -
connections.json在工作区目录内,比如workspace6/General/.dbeaver/connections.json,记录连接参数 - 删
workbench.xmi不会影响它们——但如果你误删了整个workspace6目录,这些就真没了
真正容易被忽略的是:重置后首次启动时,DBeaver 会尝试加载上次关闭前的所有 SQL 编辑器标签页。如果那些脚本太大、或含非法字符,可能导致界面再次卡住。建议先关掉自动恢复编辑器(设置里搜 restore editors 关掉),等界面稳定后再手动打开需要的文件。


















