在 Mac 上卸载 WezTerm

先保存终端里的工作，正常结束远程会话、本地服务和构建任务，再退出 WezTerm。配置是你自己写的 Lua 文件，通常是 ~/.wezterm.lua 或 ~/.config/wezterm/wezterm.lua，先复制到备份位置，再决定是否删除。卸载终端不需要清掉 shell 配置、SSH 配置或项目文件。本页覆盖 wezterm.org 官网的 zip 包和 Homebrew cask。

退出 WezTerm，包括它的复用服务

从菜单退出 WezTerm。关闭窗口不一定会停止独立运行的服务：如果用了 WezTerm 的多路复用功能，窗口关掉后 wezterm-mux-server 进程仍可能保持会话。用下面的命令检查，结束或断开还需要的会话，确认这些会话都处理完后再停止复用服务。然后把 WezTerm 从「应用程序」移到废纸篓。

WezTerm 的文件在哪里

WezTerm 会按配置说明里的顺序加载找到的第一个配置文件：$HOME/.config/wezterm/wezterm.lua 排在 $HOME/.wezterm.lua 之前，WEZTERM_CONFIG_FILE 里设置的路径优先于两者。在 Finder 按 Shift + Command + G 逐个打开。

位置	存放内容	保留还是删除
`~/.wezterm.lua`	你的配置文件	先备份；准备重装就保留。
`~/.config/wezterm`	配置目录，里面有 `wezterm.lua` 时优先使用	同上。
`~/.local/share/wezterm`	WezTerm 在 macOS 上的运行时目录（WezTerm 源代码）	WezTerm 和复用服务都停止后可以删。

检查结果

pgrep -il wezterm
command -v wezterm
ls -d ~/.wezterm.lua ~/.config/wezterm ~/.local/share/wezterm

pgrep 没有输出，说明没有 WezTerm 进程在运行；出现 wezterm-mux-server，说明复用服务还在保持会话。command -v wezterm 打印了路径，说明 PATH 里还有 wezterm 命令，要核对它是不是指向已删除的应用。ls 报 No such file or directory，说明该项目已经不在；列出了路径说明还在磁盘上，你保留的配置出现在这里是正常的。

移除 WezTerm 应用不会自动停止由 shell 启动的远程服务或后台任务。先在保留的终端里确认任务归属，再停止真正不需要的进程；不能因为进程名含 WezTerm 就清空 shell、SSH 或项目目录。

用 Homebrew 安装时

Mole 会先检查 zap 清单，涉及未勾选的数据、其他应用共用的文件或无法确认的内容时不执行 --zap，已勾选的残留仍由 Mole 清理。

自己运行 brew uninstall --cask --zap wezterm 时，zap 清单不看你在 Mole 里勾了哪些行。这份清单只包括 ~/.local/share/wezterm 和窗口恢复状态，所以 ~/.wezterm.lua 和 ~/.config/wezterm 会留下。这个 cask 还会移除它链接到 Homebrew bin 目录的 wezterm、wezterm-gui、wezterm-mux-server 和 strip-ansi-escapes 命令。

Mole 会列出什么

位置	删除计划里的状态
`~/.wezterm.lua`	会列出，但不默认勾选。
`~/.config/wezterm`	会列出，但不默认勾选。
`~/.local/share/wezterm`	会列出，但不默认勾选。

有意保留配置、方便以后重装，不算卸载失败。重装后要恢复外观和快捷键，把备份的配置放回原位置，再核对 WezTerm 实际加载的是哪个文件。WezTerm

这次检查覆盖了什么

2026 年 9 月 17 日用官网 zip 包安装 WezTerm，再通过 Mole 卸载。首次启动写出了 ~/.local/share/wezterm，当时 Mole 没有列出它。两个配置行依据的是 WezTerm 文档中的配置位置；测试没有创建配置文件，多路复用也没有测试。