バージョンの切替

方法は幾つかあるが、ここではよく使うもののみを紹介する。

他の方法や優先順位については、後述の『補足: 仕様詳細』を参照。

デフォルトの切替

以下のコマンドを実行する。


> rustup default nightly

なお、この方法は IDE からのビルド時にも有効である。

ディレクトリ単位の切替

プロジェクトのルートディレクトリに rust-toolchain.toml を配置する。


[toolchain]
channel = "nightly"

なお、この方法は IDE からのビルド時にも有効である。

一時的な切替

コマンドをバージョン指定で実行する。

rustup からの場合、以下のように実行する。


> rustup run nightly cargo build

cargo からの場合、以下のように実行する。


> cargo +nightly build

バージョンの確認

rustup show コマンドでバージョンの確認ができる。

サンプル

以下では、stable と nightly がインストールされており、選択されているのは後者で、またそれが rust-toolchain.toml ファイルの影響である事が分かる。


> rustup show
Default host: x86_64-pc-windows-msvc
rustup home:  C:\Users\nossi\.rustup

installed toolchains
--------------------

stable-x86_64-pc-windows-msvc (default)
nightly-x86_64-pc-windows-msvc

active toolchain
----------------

nightly-x86_64-pc-windows-msvc (overridden by 'D:\development\rust_test\rust-toolchain.toml')
rustc 1.81.0-nightly (5affbb171 2024-07-18)