如何在 Mac 上卸载 Hyper
卸载 Hyper 后真正会心疼的是配置文件 .hyper.js 和插件文件夹 .hyper_plugins,在 Mac 上它们可能在两个地方,一处是 Hyper 文档写的 ~/Library/Application Support/Hyper 里面,另一处是家目录根下,也就是 Hyper 仍然会读的旧位置,删任何东西之前先把你在用的那份复制出来。这篇覆盖官网的 arm64 zip 安装包和 Homebrew cask hyper 两种安装方式。
先保存配置和插件
Hyper 官网给出的 macOS 位置是 ~/Library/Application Support/Hyper/.hyper.js 和 ~/Library/Application Support/Hyper/.hyper_plugins,旧的 ~/.hyper.js 和 ~/.hyper_plugins 仍然支持,但应用文件夹里已经有配置时会被忽略,首次运行时 Hyper 会把它们迁移过去。这次实测里家目录根下也有这两项,所以两处都看一眼:
ls -la ~/Library/Application\ Support/Hyper
ls -ld ~/.hyper.js ~/.hyper_plugins
- 列表里有
.hyper.js,说明你现在的配置在 Application Support 里,想保留就复制这个文件夹。 - 某一项提示「No such file or directory」,说明那个位置没有它。
- 两处都有
.hyper.js时,Hyper 用的是 Application Support 里那份。
退出 Hyper,移除应用
- 关掉打开的终端会话,从菜单退出 Hyper。
- 打开「活动监视器」,确认没有残留的
Hyper进程。 - 在 Finder 的「应用程序」里把 Hyper 移到废纸篓。Hyper 官网和它的 GitHub 仓库都没有卸载说明,下面其余的位置来自这篇指南记录的本地测试和 Homebrew cask 的 zap 清单。
数据存在哪里
| 位置 | 里面是什么 | 如何处理 |
|---|---|---|
| ~/Library/Application Support/Hyper | 按文档说法,Hyper 的配置和插件都在这里 | 会列出但默认不勾选,想沿用配置就先复制 .hyper.js |
| ~/.hyper.js | 放在家目录旧位置的配置文件 | 会列出但默认不勾选 |
| ~/.hyper_plugins | 放在家目录旧位置的插件 | 会列出但默认不勾选 |
| ~/Library/Caches/co.zeit.hyper | 应用缓存 | 默认勾选 |
| ~/Library/Caches/co.zeit.hyper.ShipIt | 更新器缓存 | 默认勾选 |
| ~/Library/Cookies/co.zeit.hyper.binarycookies | Cookie | 默认勾选 |
| ~/Library/Logs/Hyper | 应用日志 | 默认勾选 |
| ~/Library/Preferences/co.zeit.hyper.plist | 应用偏好设置 | 默认勾选 |
| ~/Library/Preferences/co.zeit.hyper.helper.plist | 辅助进程的偏好设置 | 默认勾选 |
| ~/Library/Saved Application State/co.zeit.hyper.savedState | 窗口状态 | 默认勾选 |
用 Homebrew 安装时
hyper 这个 cask 的 zap 清单里有 ~/.hyper.js 和 ~/.hyper_plugins,都在 ~/Library 之外,另外还有 Application Support/Hyper 和上面的缓存、Cookie、日志、偏好设置、窗口状态。zap 清单只要伸到 ~/Library 之外,Mole 就不加 --zap,所以不管你勾了什么,Mole 卸载 Homebrew 装的 Hyper 都不带 --zap,你勾选的行照样由它自己移进废纸篓。
这个 cask 还会链接一个 hyper 命令,Homebrew 会跟应用一起移除它。
自己运行 zap 步骤,两处的配置和插件都会被删掉:
brew uninstall --cask --zap hyper
想保留配置和插件,先复制出来,或者只移除应用:
brew uninstall --cask hyper
核对卸载结果
pgrep -il hyper
command -v hyper
ls -d ~/Library/Application\ Support/Hyper ~/.hyper.js ~/.hyper_plugins
pgrep没有输出,说明没有 Hyper 进程在运行,它不区分大小写,列出了东西就看清进程名。command -v没有输出,说明当前 shell 的 PATH 里找不到hyper命令,有输出说明它还能解析到某个位置,需要单独查一下。ls -d会打印出还存在的项,其余的提示「No such file or directory」,你选择保留的项还在是正常的。
Mole 会列出什么
对官网下载版的 Hyper:
~/Library/Application Support/Hyper、~/.hyper.js和~/.hyper_plugins会列出但默认不勾选,配置和插件留不留由你决定。- 归在
co.zeit.hyper或Hyper名下的缓存、Cookie、日志、偏好设置和窗口状态默认勾选。
用 Homebrew 安装时,zap 清单会碰到 ~/.hyper.js 和 ~/.hyper_plugins,所以不管你勾没勾,Mole 都不加 --zap。
这次检查覆盖了什么
2026 年 9 月 20 日,从官网 arm64 zip 把 Hyper 3.4.1 拷进「应用程序」,打开后用 Mole 1.15 的 Preview 构建(build 282)全选卸载,没有 Homebrew 安装记录。Application Support/Hyper 跟应用一起进了废纸篓,家目录根下的 ~/.hyper.js 和 ~/.hyper_plugins 没有列出,应用移除后留在了磁盘上,这两行待确认是这次测试之后才加进 Mole 的。插件和 Homebrew cask 都没有测到。
