HOWTO · Python

Miniconda を完全にアンインストールする

Windows、macOS、Linux で Miniconda を安全に削除し、必要な場合のみ任意の残存データを消去します。

このページの内容

Miniconda を安全にアンインストールするには、残したい環境を先にエクスポートし、正確なインストールプレフィックスを確認してから、OS 用のアンインストーラーを使います。完全にリセットする意図がある場合だけ、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 とユーザーデータの残りを削除する

中核のアンインストールでは conda 関連のすべてのファイルを削除する必要はありません。ユーザーアカウントの conda をリセットしたい場合だけ、次の手順を選びます。

  • conda がまだ使えるうちに、インストールを削除する前に conda init --reverse --all で shell 初期化を元に戻します。代わりに、確認した startup ファイルから conda 初期化ブロックだけを削除できます。
  • 設定、キャッシュ済みパッケージ、その他のユーザー状態が不要な場合だけ .condarc、.conda、.continuum を削除します。不明な場合は先にコピーを残してください。
  • .bashrc、.zshrc、PowerShell プロファイルに古い Miniconda パスがないか確認します。削除したインストールを参照する行だけを消し、新しい端末を開きます。

anaconda-clean を Miniconda の主なアンインストーラーとして使わないでください。これはクリーンアップ用ユーティリティです。サポートされるアンインストーラーまたは慎重に確認した手動代替策が、インストール自体を処理します。クリーンアップは再インストール時には有用ですが、ディレクトリの領域を取り戻すだけなら不要です。

結果を確認し、必要なら再インストールする

確認では、削除したプレフィックスがなくなり、新しい端末で conda やそのプレフィックスの古い Python が解決されないことを確認します。Windows では where conda、macOS/Linux では command -v conda を使います。何か見つかった場合は、PATH を変えたり他を削除したりする前に場所を比較してください。

後で古い設定ファイルを戻さずに Miniconda を再インストールし、保存した YAML から環境を作成できます。ファイル使用中や権限拒否で失敗した場合は、使用中のプログラムを閉じ、適切な権限でサポートされるアンインストーラーを再実行します。確認していないパスを強制削除しないでください。