rustup

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…] COMMAND
• rustup component [options…] COMMAND
• rustup target [options…] COMMAND

• show: 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로 범위를 제한하는 편이 안전하다.

• proxy가 아닌 system cargo가 먼저 실행되면 cargo +stable 문법이 실패할 수 있다. PATH에서 rustup proxy가 앞서는지 확인한다.
• target 추가만으로 C linker나 platform SDK까지 설치되지는 않는다.
• 제거는 destructive operation이다. rustup self uninstall은 rustup이 관리한 toolchain과 data를 제거하므로 실행 전 rustup show를 확인한다.

+ rustup --help

로컬 실행 파일이 없어 live output을 수집하지 않았다.
rustup --help
rustup help toolchain

+

• rust
• rustc
• cargo
• The rustup book

• codex:: 2026-07-20 Added rustup toolchain, component, target, profile, and troubleshooting reference.