如何在 Mac 上卸载 Espanso

Espanso 是在后台运行的文字替换工具，你写的替换规则、配置文件和装过的素材包都在同一个文件夹 ~/Library/Application Support/espanso 里，数据设置可能预先勾上它，卸载前要核对，只要写过替换规则，移除应用前就先备份它。这篇覆盖 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 还在列表里就把它关掉。

数据存在哪里

停掉 Espanso 并核对备份后，在访达按 Shift + Command + G 打开存在的路径，把不再需要的应用专属数据移到废纸篓。移除 LaunchAgent 前先确认服务已停止，只删 plist 不会停掉已经加载的任务。

核对卸载结果

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 的偏好设置和窗口状态，关闭「卸载时一并移除数据和配置」时，配置文件夹起初不勾选，开启后，符合归属和批选条件时可能预先勾上，保持未勾选就会阻止 --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 清单会碰到配置文件夹，保持这一行未勾选就会阻止 --zap，不论起初未勾选还是被数据设置预选。

这次检查覆盖了什么

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