如何在 Mac 上卸载 Kodi
先备份 Kodi 媒体库、片源和插件设置里想保留的内容再卸载，这些内容放在 Mole 列出来让你自己确认的目录里，不会被自动删除。这份指南覆盖 kodi.tv 官网安装包和 Homebrew cask kodi，两者装的是同一个签名应用。
退出 Kodi，移除应用
- 从应用菜单或按 Cmd+Q 退出 Kodi。实测中没有发现 Kodi 注册菜单栏助手或登录项，不用额外处理。
- 在 Finder 的「应用程序」里找到 Kodi，移到废纸篓。如果提示正在使用，先退出剩余的 Kodi 进程再删除数据。
数据放在哪里
| 位置 | 内容 | 处理建议 |
|---|---|---|
| ~/Library/Application Support/Kodi | 媒体库数据库、插件设置和皮肤 | 默认列出但不勾选，先查看内容，想保留的先备份再移除。 |
| ~/.kodi | 家目录里的 Kodi 文件夹，这次测试时是空的 | Mole 还可能从这个应用的 Homebrew zap 清单里列出 ~/.kodi，默认不勾选。 |
| ~/Library/Preferences/org.xbmc.kodi.plist | 应用偏好设置 | 默认勾选。 |
| ~/Library/Logs/kodi.log | Kodi 的日志文件 | 默认勾选。 |
| Kodi 的单次运行临时缓存 | 每次运行由 macOS 自动创建，位于 getconf DARWIN_USER_TEMP_DIR 打印出的目录下的 C/org.xbmc.kodi 子目录 |
默认勾选，删除安全，macOS 需要时会重新创建。 |
用 Homebrew 安装时
Mole 会先检查 zap 清单，涉及未勾选的数据、其他应用共用的文件或无法确认的内容时不执行 --zap，已勾选的残留仍由 Mole 清理。
kodi 这个 cask 的 zap 清单包含 ~/.kodi、~/Library/Application Support/Kodi、~/Library/Logs/kodi.log、~/Library/Logs/kodi.old.log、~/Library/Preferences/org.xbmc.kodi.plist，还有 ~/Library/Saved Application State/org.xbmc.kodi.savedState。因为 ~/.kodi 和 Application Support 这两行默认不勾选，Mole 不加 --zap，只清理你在列表里选中的部分。
想保留媒体库和插件设置，先备份，或者只移除应用本体：
brew uninstall --cask kodi
自己运行 brew uninstall --cask --zap kodi 会把上面全部路径移进废纸篓，不看 Mole 里的勾选。
核对卸载结果
pgrep -il kodi
ls -d ~/.kodi
ls -d ~/Library/Application\ Support/Kodi
ls -d ~/Library/Preferences/org.xbmc.kodi.plist
pgrep没有输出，说明没有 Kodi 进程在运行。ls -d ~/.kodi打印出路径，说明这个目录还在，如果你选择不勾选它，这是正常结果；提示「No such file or directory」说明已经删除。ls -d ~/Library/Application\ Support/Kodi打印出路径，说明媒体库数据库和插件设置还在，你想保留重装时用就是正常结果。ls -d在偏好设置文件上返回「No such file or directory」说明已移除，权限错误是另一种情况，需要单独排查。
Mole 会列出什么
对官网下载或 Homebrew cask 安装的 Kodi：
~/Library/Preferences/org.xbmc.kodi.plist、~/Library/Logs/kodi.log和单次运行的临时缓存默认勾选。~/Library/Application Support/Kodi会列出，但默认不勾选。- Mole 还可能从这个应用的 Homebrew zap 清单里列出
~/.kodi，默认不勾选。
这次检查覆盖了什么
2026 年 9 月 25 日，从 kodi.tv 官方镜像（与 Homebrew cask 声明的地址相同）下载 Kodi 21.3，不经过 brew 直接拷进 /Applications，打开一次，再用 Mole 的开发构建卸载，这台 Mac 上缓存着 Homebrew 的 cask 清单。Mole 列出五行，偏好设置文件、kodi.log 和临时缓存默认勾选，8 MB 的 Application Support 文件夹和空的 ~/.kodi 默认不勾选，测试时全部勾上，五行都和应用一起进了废纸篓，按 Kodi 首次运行写下的全部路径复查，没有剩下任何东西。这次测试没有覆盖保留 Application Support 文件夹这一默认状态，也没有测试插件安装、媒体播放或遥控配对。