Rust release channel, toolchain, component, compilation target을 설치하고 전환하는 공식 toolchain manager.
rustup은 stable, beta, nightly 및 특정 version toolchain을 관리하고 rustc, cargo 같은 proxy가 선택된 toolchain을 실행하도록 연결한다.
platform별 공식 설치 명령과 Windows prerequisite는 Rust Installation을 따른다.
rustup --version
rustup default stable
rustup [options] [command] rustup +toolchain [command]
rustup toolchain [options…] COMMANDrustup component [options…] COMMANDrustup target [options…] COMMANDshow: active toolchain과 installed target 상태를 표시.update [TOOLCHAIN]: installed toolchain을 갱신.default TOOLCHAIN: global 기본 toolchain을 선택.toolchain install TOOLCHAIN: toolchain 설치.toolchain uninstall TOOLCHAIN: 지정 toolchain 제거.override set TOOLCHAIN: 현재 directory tree에 toolchain override 지정.override unset: 현재 directory override 제거.component add COMPONENT: rustfmt, clippy, rust-src 같은 component 설치.target add TARGET: cross-compilation용 standard library 설치.which COMMAND: 선택된 toolchain의 실제 binary path 표시.doc: 설치된 local Rust documentation 열기.rustup show rustup update stable rustup toolchain install nightly rustup component add rustfmt clippy rustup target list --installed rustup target add wasm32-unknown-unknown rustup override set stable cargo +nightly --version rustup which rustc
minimal: rustc, rust-std, cargo 중심의 최소 profile. CI에 유용하다.default: minimal에 rust-docs, rustfmt, clippy를 추가한 일반 개발 권장 profile.complete: 모든 component를 요구해 실패하기 쉬우므로 공식 문서도 사용을 권장하지 않는다.
toolchain 이름은 stable, beta, nightly, version, date, host tuple 조합을 사용할 수 있다. nightly-only 기능은 project의 rust-toolchain.toml 또는 directory override로 범위를 제한하는 편이 안전하다.
cargo가 먼저 실행되면 cargo +stable 문법이 실패할 수 있다. PATH에서 rustup proxy가 앞서는지 확인한다.rustup self uninstall은 rustup이 관리한 toolchain과 data를 제거하므로 실행 전 rustup show를 확인한다.