如何在 Mac 上卸载 MySQL Workbench
把 MySQL Workbench 移进废纸篓不会删掉你保存的连接、SQL 代码片段和查询历史,MySQL 自己的文档写得很清楚,应用移除之后这些内容还留在一个单独的配置文件夹里。打算重装或者换到另一台 Mac,先把这个文件夹备份出来。这篇覆盖官网下载的磁盘映像和 Homebrew cask mysqlworkbench 两种安装方式。
退出 MySQL Workbench,移除应用
- 结束正在跑的查询,关掉打开的 SQL 标签页,再从菜单退出 MySQL Workbench。
- 打开「活动监视器」,确认没有残留的
MySQLWorkbench进程。 - 在 Finder 的「应用程序」里把 MySQL Workbench 移到废纸篓,这是 MySQL 官方卸载说明里写的方法。
决定连接和代码片段的去留
MySQL 的文档写明,卸载应用不会删除 Workbench 的配置目录,里面是你保存的连接、设置、缓存文件、SQL 代码片段和历史记录、日志以及自定义模块。先看看里面都有什么,想留着以后用的东西记得备份。
同一份文档还提到,MySQL Workbench 会在 MySQL 服务器上建一个 .mysqlworkbench schema,用来在同一个连接里共享 SQL 代码片段,它在数据库服务器那一端,不在你的 Mac 上,卸载应用不会碰它,不想要了就自己到那台服务器上删掉。
| 位置 | 里面是什么 | 如何处理 |
|---|---|---|
| ~/Library/Application Support/MySQL/Workbench | 保存的连接、设置、缓存、SQL 代码片段和历史记录、日志、自定义模块 | 会列出但默认不勾选,想保留连接就先备份再删 |
| ~/Library/Caches/com.oracle.workbench.MySQLWorkbench | 应用缓存 | 默认勾选 |
| ~/Library/Preferences/com.oracle.workbench.MySQLWorkbench.plist | 应用偏好设置 | 默认勾选 |
| ~/Library/Saved Application State/com.oracle.workbench.MySQLWorkbench.savedState | 窗口状态 | 默认勾选 |
Mole 从不动共享的 MySQL 文件夹本身,只处理里面的 Workbench 子文件夹,其他可能用到这个父目录的 MySQL 工具不受影响。
用 Homebrew 安装时
Mole 会先检查 zap 清单,碰到你没勾选的一行就不执行 --zap,已勾选的部分仍然通过它自己可恢复的废纸篓步骤清理。
mysqlworkbench 这个 cask 的 zap 清单和上面四个位置完全对应,包括你的连接文件夹。因为这个文件夹默认不勾选,Mole 卸载时通常只跑不带 --zap 的 brew uninstall --cask mysqlworkbench。如果你把连接文件夹也勾上,zap 清单里的每一项就都在你的选择范围内了。
自己运行 zap 步骤会不看 Mole 里的勾选,把上面所有内容都移进废纸篓:
brew uninstall --cask --zap mysqlworkbench
想保留连接,先备份 Application Support/MySQL/Workbench,或者只移除应用:
brew uninstall --cask mysqlworkbench
核对卸载结果
pgrep -il mysqlworkbench
ls -d ~/Library/Application\ Support/MySQL/Workbench
pgrep没有输出,说明没有 MySQL Workbench 进程在运行,列出进程就先退出应用再处理数据。ls -d打印出路径,说明配置文件夹还在,选择保留时这是正常结果,提示「No such file or directory」说明已经不在了。
Mole 会列出什么
对官网磁盘映像装的 MySQL Workbench:
~/Library/Application Support/MySQL/Workbench会列出但默认不勾选,由你决定连接和代码片段的去留。- 归在
com.oracle.workbench.MySQLWorkbench名下的缓存、偏好设置和窗口状态文件默认勾选。 - 共享的
MySQL文件夹本身从不移除。
用 Homebrew 安装时,zap 清单会碰到你的连接文件夹,所以 Mole 通常不加 --zap,除非你把那一行也勾上。
这次检查覆盖了什么
2026 年 9 月 19 日,从官网磁盘映像把 MySQL Workbench 8.0.47 社区版拷进「应用程序」,打开一次,再用 Mole 1.15 的 Preview 构建(build 277)卸载,没有 Homebrew 安装记录。首次运行时它已经写出了 Application Support/MySQL/Workbench,里面有 connections.xml,那个构建没有列出这个文件夹,应用移除后它留在了磁盘上,上面那一行待确认是这次测试之后才加进 Mole 的。连接数据库、服务器上的 .mysqlworkbench schema 和 Homebrew cask 都没有测到。
