如何在 Windows 上卸载 WezTerm
退出 WezTerm 前先保存终端里的工作,结束远程会话、本地服务和正在跑的构建。配置是你自己写的 Lua 文件,一般在 %USERPROFILE%\.wezterm.lua 或者 %USERPROFILE%\.config\wezterm\wezterm.lua,删之前先复制一份备份。这份指南覆盖用 wez.wezterm winget 包按机器安装的 WezTerm。
退出 WezTerm,包括它的多路复用服务
关闭所有 WezTerm 窗口。关掉窗口不代表独立跑着的服务也停了,用过 WezTerm 的多路复用功能的话,wezterm-mux-server 进程可能在窗口关掉之后还留着会话。用下面的命令检查一下,把还需要的会话处理完或者断开连接,确认这些会话都结束了再停掉 mux 服务。然后卸载前在任务管理器(Ctrl+Shift+Esc)里确认没有 wezterm-gui.exe 还在。
用自带的卸载器移除应用
打开「设置 › 应用 › 已安装的应用」,找到 WezTerm,选择卸载,或者运行:
winget uninstall --id wez.wezterm
数据分别在哪里
WezTerm 按自己配置指南里写的顺序找配置文件,%USERPROFILE%\.config\wezterm\wezterm.lua 排在 %USERPROFILE%\.wezterm.lua 前面。
| 位置 | 里面是什么 | 如何处理 |
|---|---|---|
%USERPROFILE%\.wezterm.lua |
你的配置文件,如果放在这里 | 先备份,想重装的话留着 |
%USERPROFILE%\.config\wezterm |
配置目录,里面有 wezterm.lua 时会用这个 |
处理方式同上 |
%USERPROFILE%\.local\share\wezterm |
WezTerm 的运行时目录,放着运行会话的套接字和日志文件 | WezTerm 和它的 mux 服务都停了之后可以删 |
检查结果
卸载完成后运行下面几条只读命令:
Get-Process wezterm-gui, wezterm-mux-server -ErrorAction SilentlyContinue
winget list --id wez.wezterm
Test-Path "$env:ProgramFiles\WezTerm"
Test-Path "$env:USERPROFILE\.local\share\wezterm"
Get-Process没有输出只表示未观察到匹配进程,被忽略的查询错误不能当作已经退出。winget list正常完成且没有匹配,才说明包记录已经没了;列出一行,说明卸载没完成。- 第一条
Test-Path返回True,只说明程序目录还在,打开看一眼才知道留下了什么,这个结果不能说明目录是空的。 Test-Path "$env:USERPROFILE\.local\share\wezterm"返回True,说明 WezTerm 的运行时目录还在,只要你没有自己删掉,这就是正常的。
卸载 WezTerm 不会自动停掉远程服务或者在某个 shell 里启动的后台任务。先在留着的终端里确认每个任务是什么,再决定停不停,不要因为进程名字带 WezTerm 就删掉 shell、SSH 或者项目文件夹。
用 winget 安装时
winget uninstall 运行的是「设置 › 应用」用的同一个 Inno Setup 卸载器,删的是同一批程序文件,它不会主动动你的 Lua 配置文件或者 %USERPROFILE%\.local\share\wezterm。
Mole 会列出什么
| 位置 | 在审查里 |
|---|---|
| 程序目录和公共开始菜单快捷方式 | 默认勾选 |
%USERPROFILE%\.local\share\wezterm |
会列出,但默认不勾选 |
你的 .wezterm.lua 文件和 .config\wezterm 文件夹,不管放在哪里,都不在这份列表里。留着配置是为了以后重装能用,不是卸载没做干净。
这次检查覆盖了什么
2026 年 10 月 3 日在 ARM64 虚拟机复测,通过 winget 按机器安装 WezTerm 20240203-110809-5046fc22,全选审查行后,程序目录和运行时目录都已移除,开始菜单快捷方式由卸载器先删掉,早先测试留下空目录的情况没有再出现。没有测试:多路复用服务 wezterm-mux-server,以及一次真的存在 Lua 配置文件的安装。
