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 Miniconda 解除安裝指南說明目前支援的程序。

開始前,關閉使用此安裝的命令提示字元、PowerShell、IDE 終端機和 Python 程序。解除安裝完成後,開啟新的終端機並執行 where conda。若這是唯一的 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 檔建立新環境。若因檔案使用中或權限遭拒而無法移除,請關閉使用該安裝的程式,並以適當帳戶權限重新執行支援的解除安裝程式;不要強制刪除未驗證的路徑。