如何在 Mac 上卸载 Espanso

Espanso 是在后台运行的文字替换工具，你写的替换规则、配置文件和装过的素材包都在同一个文件夹 ~/Library/Application Support/espanso 里，Mole 会列出它但默认不勾选，只要写过替换规则，移除应用前就先备份它。这篇覆盖 macOS 官网下载版和 Homebrew cask espanso 两种安装方式。

先备份替换规则

Espanso 的配置文档写明 macOS 上的配置文件夹是 ~/Library/Application Support/espanso，文档里提到的 ~/.config/espanso 是 Linux 用的位置，想保留替换规则就把这个文件夹复制到 ~/Library 之外。

停掉 Espanso，移除应用

1. 点菜单栏里的 Espanso 图标退出，平时用 espanso 命令的话，也可以照命令行参考运行 espanso stop 停掉后台服务。
2. 在 Finder 的「应用程序」里把 Espanso 移到废纸篓。
3. 打开「系统设置 › 通用 › 登录项与扩展」，Espanso 还在列表里就把它关掉。

数据存在哪里

核对卸载结果

pgrep -il espanso
launchctl list | grep -i espanso
ls -d ~/Library/Application\ Support/espanso

• pgrep 没有输出，说明没有 Espanso 进程在运行。
• launchctl list 没有输出，说明没有 Espanso 的任务在加载，出现带 com.federicoterzi.espanso 的一行，说明后台服务还注册着，LaunchAgent 文件删掉之后注销再登录一次就好。
• ls -d 提示「No such file or directory」，说明配置文件夹已经删掉了，打印出路径说明它还在，这一行没勾时是正常结果。

用 Homebrew 安装时

espanso 这个 cask 会链接一个 espanso 命令，卸载时跟应用一起移除。它的 zap 清单包括 ~/Library/Application Support/espanso、缓存、LaunchAgent、上面的偏好设置，另外两份名叫 espanso 的偏好设置和窗口状态，因为配置文件夹会列出但默认不勾选，除非你把那一行勾上，Mole 都不加 --zap，你勾选的行照样由它自己移进废纸篓。

自己运行 zap 步骤，不管 Mole 里勾没勾，替换规则和配置都会被移进废纸篓：

brew uninstall --cask --zap espanso

想保留就先复制 ~/Library/Application Support/espanso，或者只移除应用：

brew uninstall --cask espanso

Mole 会列出什么

对官网下载版的 Espanso：

• ~/Library/Application Support/espanso 会列出但默认不勾选。
• ~/Library/Caches/espanso、~/Library/Preferences/com.federicoterzi.espanso.plist 和 com.federicoterzi.espanso 这个 LaunchAgent 存在时默认勾选。
• 在 Mac 上不会列出 ~/.config/espanso。

用 Homebrew 安装时，zap 清单会碰到配置文件夹，所以除非你勾上那一行，Mole 都不加 --zap。

这次检查覆盖了什么

2026 年 9 月 19 日，从官网下载版把 Espanso 拷进「应用程序」，打开后用 Mole 1.15 的 Preview 构建（build 277）卸载，没有 Homebrew 安装记录。首次运行时它建了一个空的 Application Support/espanso，没有写 ~/.config/espanso。这次没有配置替换规则，没有用命令行注册后台服务，Homebrew cask 也没有测到。