できない.dev

conda「Run 'conda init' before 'conda activate'」の原因と直し方

Run 'conda init' before 'conda activate' は、conda init を打ってシェルを開き直せば直る。
スクリプトでは conda shell.bash hook を先に評価する。
conda の初期化コードを読んでいないシェルで出る。

公開:

要約

conda activate を打つと、環境が切り替わらずに次のエラーが出ることがある。

CondaError: Run 'conda init' before 'conda activate'

Run 'conda init' before 'conda activate' は、今のシェルに conda の初期化コードが読まれていないという意味である。
conda activate は conda の実行ファイルではなく、conda init がシェルの起動ファイルに足すシェル関数で動く。
端末なら conda init のあとに開き直し、スクリプトなら先頭で eval "$(conda shell.bash hook)" を評価すれば直る。

解決策

1. 端末では conda init のあと開き直す

conda init bash

zsh なら conda init zsh、PowerShell なら conda init powershell と、使うシェルの名前を渡す。
conda init のドキュメント(新しいタブで開く)によると、ほとんどのシェルは閉じて開き直すまで変更が効かない。
開き直したシェルでは conda activate base が通り、CONDA_DEFAULT_ENV に base が入った。

2. スクリプトでは hook を評価してから activate する

#!/bin/bash
eval "$(conda shell.bash hook)"
conda activate myenv
python script.py

conda shell.bash hook が出力する初期化コードを、そのスクリプトの中で評価する。
~/.bashrc に頼らないので、対話しないシェルでも conda activate が通る。

3. activate せずに conda run で走らせる

conda run -n myenv python script.py

環境の管理のドキュメント(新しいタブで開く)は、コマンドを 1 つ走らせるだけなら、スクリプトで activate せずに conda run を使う方法を挙げている。
Dockerfile の RUN でも、この形ならシェルの初期化は要らない。

conda activate で環境の名前を間違えた場合は、EnvironmentNameNotFound: Could not find conda environment という別のエラーが出る。
conda run -n で間違えると EnvironmentLocationNotFound: Not a conda environment になる。
conda info --envs で名前を確かめる。

よくある原因

  1. 初期化していないか、初期化したシェルを開き直していない。
    conda init bash は ~/.bashrc を書き換えたあと、変更を効かせるにはシェルを閉じて開き直すよう表示する。
  2. スクリプトの中で conda activate を打っている。
    bash run.sh のような対話しないシェルは ~/.bashrc を読まないので、初期化済みの環境でもこのエラーになる。
  3. /bin/sh で打っている。
    Dockerfile の RUN や sh -c も初期化コードを読まない。

スクリプトの途中で conda activate が失敗しても、後の行は止まらずに走る。
anaconda/miniconda のコンテナで試すと、bash run.sh はエラーを出したあと CONDA_DEFAULT_ENV が空のまま次の行を実行し、終了コード 0 で終わった。