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