上書き

rustuprustc などのインストールされたコマンドが実行されると、どのツールチェーンを使うかを自動的に決定する。どのツールチェーンが使われるべきかを制御または上書するには幾つかの方法がある:

  1. コマンドラインでのツールチェーン上書記法cargo +beta のように使用。
  2. RUSTUP_TOOLCHAIN 環境変数。
  3. ディレクトリの上書rustup override コマンドにより設定。
  4. rust-toolchain.toml ファイル。
  5. デフォルトツールチェーン

ツールチェーンは上記で示した順で選ばれ、最初に指定されたものが使われる。ただし、例外が一点: ディレクトリの上書と rust-toolchain.toml ファイルではカレントディレクトリとの近さも優先される。つまり、これらの二つの上書の方式はディレクトリツリーをファイルシステムのルートに向かって上向きに歩いて発見されるので、カレントディレクトリに近い rust-toolchain.toml ファイルはより遠くのディレクトリの上書よりも優先される。

どのツールチェーンがアクティブであるかの確認には、rustup show が使用できる。