上書き
rustupはrustcなどのインストールされたコマンドが実行されると、どのツールチェーンを使うかを自動的に決定する。どのツールチェーンが使われるべきかを制御または上書するには幾つかの方法がある:
- コマンドラインでのツールチェーン上書記法、
cargo +betaのように使用。RUSTUP_TOOLCHAIN環境変数。- ディレクトリの上書、
rustup overrideコマンドにより設定。rust-toolchain.tomlファイル。- デフォルトツールチェーン。
ツールチェーンは上記で示した順で選ばれ、最初に指定されたものが使われる。ただし、例外が一点: ディレクトリの上書と
rust-toolchain.tomlファイルではカレントディレクトリとの近さも優先される。つまり、これらの二つの上書の方式はディレクトリツリーをファイルシステムのルートに向かって上向きに歩いて発見されるので、カレントディレクトリに近いrust-toolchain.tomlファイルはより遠くのディレクトリの上書よりも優先される。どのツールチェーンがアクティブであるかの確認には、
rustup showが使用できる。