在 Mac 上卸载 Karabiner-Elements

Karabiner-Elements 会安装键盘驱动（DriverKit 系统扩展）和后台组件，不要直接拖进废纸篓。运行过安装程序的，用它自带的卸载器，它会停用驱动并移除系统文件。动手前先备份改键配置。本页覆盖 karabiner-elements.pqrs.org 官网的安装包和 Homebrew cask。

先保存键盘配置

在 Finder 按 Shift + Command + G，前往 ~/.config/karabiner，把整个文件夹复制到备份位置，里面的键位映射和复杂修改以后重装还能用。找不到这个目录就跳过。

这份安装由 Homebrew 管理时，先运行下面的驱动停用命令，再走 Homebrew 卸载，保留已安装的脚本直到流程完成，不先跑完整厂商卸载器，再让 Homebrew 调用已经删除的脚本目录。

用自带卸载器移除

打开 Karabiner-Elements 设置，进入 Uninstall 标签，点击 Launch uninstaller，按对话框操作。卸载器会要求输入管理员密码来移除文件，完成后提示重启 macOS。官方卸载说明

设置界面打不开时，同一份说明给了命令行做法：先停用驱动，再运行安装程序放在磁盘上的卸载脚本：

bash '/Library/Application Support/org.pqrs/Karabiner-DriverKit-VirtualHIDDevice/scripts/uninstall/deactivate_driver.sh'
sudo '/Library/Application Support/org.pqrs/Karabiner-Elements/uninstall.sh'

第二条命令需要管理员密码。它会移除 Karabiner-Elements.app、Karabiner-EventViewer.app、驱动文件和 /Library/Application Support/org.pqrs/Karabiner-Elements，之后重启。不要为了让图标消失，手动删除驱动或系统扩展文件夹。

卸载器会留下的文件

Karabiner 的说明写明，下面这些会留下，不影响系统，介意的话再手动删除：

只删这里列出的项目，/Library/Application Support/org.pqrs 里的其他内容交给卸载器处理。

检查结果

pgrep -il karabiner
systemextensionsctl list | grep -i karabiner
ls /Library/Application\ Support/org.pqrs

pgrep 没有输出，说明没有 Karabiner 进程在运行。systemextensionsctl 没有输出，说明没有注册 Karabiner 驱动；某一行以 [activated enabled] 结尾，说明驱动仍在启用，要运行卸载器或上面的停用命令；显示等待重启后卸载，说明重启一次就能完成。ls 仍列出 Karabiner-Elements 或 Karabiner-DriverKit-VirtualHIDDevice，说明系统文件还在；报 No such file or directory 则说明文件夹已经不在。最后确认原来的改键不再生效。

用 Homebrew 安装时

Homebrew 普通卸载还会移除它管理的 karabiner_cli 链接。

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

自己运行 brew uninstall --cask --zap karabiner-elements 时，zap 清单不看你在 Mole 里勾了哪些行。这个 cask 会运行 Karabiner 自己的移除脚本并删除 /Library/Application Support/org.pqrs，但按设计不会卸载 DriverKit 系统扩展，所以要趁这个文件夹还在，先运行上面的 deactivate_driver.sh 命令。zap 清单会把存放键位映射的 ~/.config/karabiner 和 ~/.local/share/karabiner 移到废纸篓，Karabiner 的 Application Support、容器、缓存和偏好设置也在清单里。先备份 ~/.config/karabiner；想保留它，就改用不带 zap 的 brew uninstall --cask karabiner-elements。

Mole 会列出什么

下面未勾选的数据行对应默认关闭「卸载时一并移除数据和配置」，开启后符合条件的应用自有数据可能预先勾上，要保留改键配置就取消对应行的勾选。

Mole 不会列出 /Library/Application Support/org.pqrs、/var/log/karabiner 或驱动，这些交给 Karabiner 自己的卸载器。

这次检查覆盖了什么

安装包需要管理员密码，所以 2026 年 9 月 19 日只把应用复制到「应用程序」，再通过 Mole 卸载。首次启动只写了设置应用的偏好文件。驱动、系统扩展和后台组件都没有安装，这次测试不能证明它们会被移除。