如何在 Mac 上卸载 DBeaver

你在 DBeaver 里配好的东西都在一个文件夹里，~/Library/DBeaverData，保存的连接、加密的凭据、SQL 脚本、项目、下载的驱动和设置全在这里，移除 App 不会删它，而删掉它就是一次把这些全删掉，动这个文件夹之前先把要留的导出来。数据库本身不在这台 Mac 上，除非你就在本机跑着它，卸载 DBeaver 不会碰你的数据库。这份指南覆盖从 dbeaver.io 下载的官方版本和 Homebrew cask dbeaver-community，两者装的是同一个 DBeaver Community。

先导出连接和脚本

在 DBeaver 里选择「File › Export」，再选「DBeaver › Projects」，把项目连同其中的连接和脚本导出成一个归档，之后可以用「File › Import」导回来（见 DBeaver 项目文档），导出后打开保存位置确认文件真的在。最容易丢的是保存的密码，在另一台 Mac 或重装后的 DBeaver 里导入之后，先打开一个连接确认还能登录，再去删任何东西。

只想要原始文件的话，默认项目的连接列表在 data-sources.json，加密凭据在 credentials-config.json，都在 ~/Library/DBeaverData/workspace6/General/.dbeaver 里（见 连接配置文件），复制时整个 .dbeaver 文件夹一起复制，别只挑单个文件。

在「Window › Preferences › General › Security」里打开集成安全后，DBeaver 还会把一个自动生成的主密码存进 macOS 钥匙串（见 集成安全）。移除 DBeaver 不会动这个钥匙串项目，Mole 也从不读取或删除钥匙串里的内容。

退出 DBeaver，移除 App

从 App 菜单退出 DBeaver。它跑在一个 Java 进程里，App 看起来没退干净的话，去「活动监视器」搜 dbeaver。然后把 DBeaver 从「应用程序」拖进废纸篓。实测时 App 移除之后，「系统设置 › 通用 › 登录项与扩展」里还留着一条指向已删 App 的 DBeaver，它什么也不会启动，可以在那里关掉。

DBeaver 的数据放在哪里

~/Library/DBeaverData 不只属于 DBeaver Community，DBeaver Lite 用的也是这个文件夹，它的 Homebrew cask 同样列着它，这台 Mac 上还装着别的 DBeaver 版本时，别动这个文件夹。

检查结果

在终端运行下面几条只读命令：

pgrep -il dbeaver
ls -d ~/Library/DBeaverData
ls ~/Library/DBeaverData/workspace6/General/.dbeaver

• pgrep 没有输出，说明 DBeaver 已经退出。
• ls -d 那一行打印出路径，说明 DBeaver 的数据还在，你选择保留时这是正常结果，提示「No such file or directory」说明已经不在。
• 最后一行列出默认项目的连接文件，看到 data-sources.json 说明连接还在磁盘上，提示「No such file or directory」要么是整个文件夹已经没了，要么是你从没用过默认项目。

用 Homebrew 安装时

dbeaver-community 这个 cask 卸载时会停掉 DBeaver，并移除它链接的 dbeaver 命令。它的 zap 清单包括 ~/Library/DBeaverData（所有连接、凭据和脚本），以及缓存、HTTP 存储、偏好设置和窗口恢复状态，运行 brew uninstall --cask --zap dbeaver-community 会把这些全部移进废纸篓，不看 Mole 里勾了什么，DBeaver Lite 还在用这个文件夹也照删。想保留数据，只移除 App：

brew uninstall --cask dbeaver-community

只有 zap 清单里的每一项都在你自己的 ~/Library 里、都没有碰到你没勾的行、也没有被其他已装应用认领时，Mole 才会加上 --zap。~/Library/DBeaverData 会列出但默认不勾选，还装着别的 DBeaver 版本时也会挡住 zap，这些情况下 Mole 卸载时不带 --zap，只移走你勾选的行。

Mole 会列出什么

用 Mole 卸载时：

• ~/Library/DBeaverData 会列出但默认不勾选，你不勾，连接和脚本就留着。
• 以 org.jkiss.dbeaver.core.product 命名的缓存、HTTP 存储、偏好设置 plist 和窗口恢复状态默认勾选，DBeaver 的崩溃报告也默认勾选。
• 钥匙串项目不在卸载范围内，Mole 也不会连接数据库服务器删除数据。

这次检查覆盖了什么

2026 年 9 月 19 日，安装官网下载的 DBeaver Community，再用 Mole 的 Preview 构建卸载，这一轮显示了待确认列表。崩溃报告默认勾选并被移走，~/Library/DBeaverData 当时不在 Mole 的清单里，留在了磁盘上，上面说的待确认行是同一批测试里补进 Mole 的。另外还剩一条指向已删 App 的登录项。记录里没有连接和脚本，所以导出、凭据和钥匙串项目都没有测到，Homebrew cask 也不在测试范围内。