在 Mac 上卸载 Podman Desktop

先决定只卸载 Podman Desktop 界面，还是连 Podman 引擎和它的机器一起移除。它们不是同一个安装项，机器里的容器、镜像和数据卷也不能当普通缓存清掉。卸载 Podman Desktop 不会移除 Podman、它的机器或你创建的 Kubernetes 集群。本页按 Podman Desktop 官方卸载说明处理 DMG 和 Homebrew cask 两种安装。

保存工作并停止机器

先导出或备份需要的容器数据、数据库和文件，验证副本可用，再停止写入任务和对应的 Podman machine。如果只移除桌面界面、还要通过命令行使用 Podman，就保留引擎与机器，跳过下一节。

可选：移除 Podman 引擎和机器

只有完成上面的备份后才做这一步，因为第一条命令会删除所有 Podman 机器，连同里面的容器、镜像和数据卷：

podman machine reset -f

然后按安装方式移除 Podman。用 Homebrew 安装的，运行 brew uninstall podman。由 Podman Desktop 的安装向导装上的，官方步骤是先卸载 podman-mac-helper 服务，再删除 PATH 配置和 /opt/podman 文件夹：

sudo /opt/podman/bin/podman-mac-helper uninstall

只有辅助服务卸载成功后才继续，报错就先停下，保留辅助工具文件，解决错误后再处理下面两项。逐条运行，任一条失败都停止：

sudo rm /etc/paths.d/podman-pkg
sudo rm -rfv /opt/podman

Podman 自己的文件和配置在 ~/.local/share/containers/podman 和 ~/.config/containers/podman，只删这两个文件夹。~/.local/share/containers/storage 是可选删除的存储配置，上层的 ~/.local/share/containers 可能供其他容器工具使用，不要整个删除。Kind 和 Minikube 集群与卸载 Desktop 是分开的，先确认某个集群属于本次移除范围并核对数据备份，再在界面中选择这一个集群删除，或把 kind delete cluster --name <cluster-name> 的 <cluster-name> 换成已确认的集群名，Minikube 则把 minikube delete --profile <profile-name> 的 <profile-name> 换成已确认的配置名，保留其他集群与配置，具体参数见 Kind 的按名删除说明和 Minikube 的指定配置删除说明。

移除 Podman Desktop

退出 Podman Desktop，把它从「应用程序」移到废纸篓。如果设置过登录时打开，之后到「系统设置 › 通用 › 登录项与扩展」核对。再决定 ~/.local/share/containers/podman-desktop 的去留：这里是 Desktop 的配置，extensions-storage 里还有扩展装上的二进制文件和插件。在 Finder 按 Shift + Command + G 打开查看。

检查结果

pgrep -il podman
podman machine list
ls -d ~/.local/share/containers/podman-desktop ~/.local/share/containers/podman ~/.config/containers/podman

pgrep 没有输出只表示进程名没有匹配 podman，机器也可能通过 vfkit 或 krunkit 等其他名称的虚拟化进程运行。保留了命令行时，podman machine list 会列出保留的机器及运行状态；有机器不表示 Desktop 卸载失败，空列表也只说明当前 Podman 环境没有列出机器。报 command not found，只说明当前 shell 的 PATH 里已经没有 Podman 命令，不能证明所有数据文件都没了。ls 报 No such file or directory，说明该文件夹已经不在；列出了路径说明还在磁盘上。卸载后命令行仍能运行容器，只说明引擎还在，不代表桌面应用卸载失败。

用 Homebrew 安装时

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

自己运行 brew uninstall --cask --zap podman-desktop 时，zap 清单不看你在 Mole 里勾了哪些行。它会把存放 Desktop 设置和扩展存储的 ~/.local/share/containers/podman-desktop，以及 ~/Library/Application Support/Podman Desktop 移到废纸篓，偏好设置和窗口恢复状态也在清单里；cask 的卸载步骤还会移除它的登录 launch agent。它不会碰 Podman 引擎、机器或 ~/.local/share/containers/podman。先备份 Desktop 的文件夹，或改用不带 zap 的 brew uninstall --cask podman-desktop 保留它。

Mole 会列出什么

默认关闭「卸载时一并移除数据和配置」时，两条 Desktop 数据需确认行不勾选，开启后符合条件的应用自有数据可能预先勾选，想保留 Desktop 设置和扩展存储就取消它们的勾选。

Mole 从不列出上层的 ~/.local/share/containers、Podman 引擎的文件夹、机器或 /opt/podman。

这次检查覆盖了什么

2026 年 9 月 19 日用 Homebrew cask 安装 Podman Desktop，再通过 Mole 卸载，过程中执行了 zap 清单。在 Mole 处理之前，zap 已经删掉了 ~/.local/share/containers/podman-desktop，所以 Mole 会为 DMG 用户列出它。卸载后它的登录项也不见了。移除 Podman 引擎、机器和 Kubernetes 集群的过程没有测试。