HOWTO · Python

彻底卸载 Miniconda

安全地在 Windows、macOS 或 Linux 上卸载 Miniconda,并仅在需要时删除可选残留。

本页内容

要安全卸载 Miniconda,请先导出希望保留的环境,确认准确的安装前缀,然后使用操作系统对应的卸载程序。只有在确实要完全重置时才删除 shell 设置和 conda 用户数据;这些可选步骤可能会丢失设置和缓存的软件包。

备份环境并确认安装前缀

卸载 Miniconda 会删除该安装目录中的环境和软件包。继续前请导出以后想重建的环境。例如运行 conda env export --name myenv > myenv.yml,并将 myenv.yml 保存在 Miniconda 目录之外;重新安装 conda 后可用 conda env create --file myenv.yml 重建。

不要仅因目录名称像 Miniconda 就删除它。在 macOS 和 Linux 上,先让 conda 返回基础前缀。下面的预检会在 conda 可用时输出目录,在不可用时于删除前停止。

if ! prefix="$(conda info --base 2>/dev/null)"; then
  printf '%s\n' 'conda is not on PATH; find the installation prefix before deleting anything.'
  exit 1
fi
printf 'Miniconda prefix: %s\n' "$prefix"

对于正常安装,最后一行的形式如下:

Miniconda prefix: /opt/miniconda3

如果预检提示 conda 不在 PATH 中,不要把猜测的路径放进删除命令。先找到原安装程序目录,或使用该安装附带的卸载程序。错误删除前缀可能会删除另一套 conda 安装,因此这里必须谨慎。

在 Windows 上卸载 Miniconda

使用 Miniconda 安装自带的 Windows 卸载程序。打开 设置 > 应用 > 已安装的应用(旧版 Windows 为 应用和功能),选择 Miniconda,再选择 卸载Anaconda 指南 说明了当前受支持的流程。

开始前关闭命令提示符、PowerShell、IDE 终端以及使用此安装的 Python 进程。卸载完成后打开新终端并运行 where conda。如果仍找到路径,请检查它;它可能属于不应误删的另一套 Anaconda、Miniconda 或 Miniforge 安装。

在 macOS 或 Linux 上卸载 Miniconda

若安装程序提供了它,请从已确认的准确 Miniconda 前缀运行 uninstall.sh。应遵循脚本提示,而不是复制通用的 rm -rf 命令;卸载程序可能会保留用户级配置。

如果没有卸载程序,手动删除只是后备方案而非首选。再次检查前缀,确认它是要删除的 Miniconda,然后只删除该目录。conda 文档说明了 macOS 的手动方法和可选清理步骤。rm -rf 不会要求确认且无法撤销;切勿对空、未经验证或像主目录这样宽泛的路径执行它。

删除后打开新的 shell 并运行 command -v conda。没有输出说明当前 PATH 已找不到该命令;若输出路径,则可能还有另一套 conda 或 shell 保留了初始化项。

删除可选的 shell 和用户数据残留

核心卸载不要求删除所有 conda 相关文件。只有希望为该用户账户重置 conda 时才选择以下步骤:

  • 在删除安装前、conda 仍可用时用 conda init --reverse --all 反转 shell 初始化;或者检查后只从相应的 shell 启动文件中删除 conda 初始化块。
  • 只有在不需要其设置、缓存软件包或其他用户状态时才考虑删除 .condarc.conda.continuum。不确定时先保留副本。
  • 检查 .bashrc.zshrc 或 PowerShell 配置文件中的过期 Miniconda 路径。仅删除引用已移除安装的行,然后打开新终端。

不要把 anaconda-clean 作为主要的 Miniconda 卸载程序。它是清理工具;受支持的卸载程序或经过仔细确认的手动后备方法才处理安装本身。可选清理适合从头重装,但仅回收 Miniconda 目录时并不需要。

验证结果并按需重新安装

验证应表明已删除的前缀不存在,并且新终端不再解析该前缀中的 conda 或旧 Python。Windows 使用 where conda;macOS 或 Linux 使用 command -v conda。在修改 PATH 或删除其他内容前,将仍找到的位置与已删除的前缀比较。

以后可以重新安装 Miniconda 而无需恢复旧配置文件,并从保存的 YAML 创建新环境。如果因文件被占用或权限被拒绝而失败,关闭使用该安装的程序,并以合适账户权限重新运行受支持的卸载程序;不要强制删除未经确认的路径。