{{tag>[cli rust rustup toolchain compiler]}}

====== rustup ======
Rust release channel, toolchain, component, compilation target을 설치하고 전환하는 공식 toolchain manager.

===== Summary =====
''rustup''은 stable, beta, nightly 및 특정 version toolchain을 관리하고 ''rustc'', ''cargo'' 같은 proxy가 선택된 toolchain을 실행하도록 연결한다.

===== Installation =====
platform별 공식 설치 명령과 Windows prerequisite는 [[rust:ko#installation|Rust Installation]]을 따른다.

<code bash>
rustup --version
rustup default stable
</code>

===== Usage =====
<code bash>
rustup [options] [command]
rustup +toolchain [command]
</code>

  * ''<color #c3c3c3>**rustup**</color> <color #ff7f27>toolchain</color> <color #22b14c>[options...]</color> <color #7092be>COMMAND</color>''
  * ''<color #c3c3c3>**rustup**</color> <color #ff7f27>component</color> <color #22b14c>[options...]</color> <color #7092be>COMMAND</color>''
  * ''<color #c3c3c3>**rustup**</color> <color #ff7f27>target</color> <color #22b14c>[options...]</color> <color #7092be>COMMAND</color>''

===== Commands =====
  * ''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 열기.

===== Examples =====
<code bash>
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
</code>

===== Profiles =====
  * ''minimal'': ''rustc'', ''rust-std'', ''cargo'' 중심의 최소 profile. CI에 유용하다.
  * ''default'': minimal에 ''rust-docs'', ''rustfmt'', ''clippy''를 추가한 일반 개발 권장 profile.
  * ''complete'': 모든 component를 요구해 실패하기 쉬우므로 공식 문서도 사용을 권장하지 않는다.

===== Compatibility =====
toolchain 이름은 ''stable'', ''beta'', ''nightly'', version, date, host tuple 조합을 사용할 수 있다. nightly-only 기능은 project의 ''rust-toolchain.toml'' 또는 directory override로 범위를 제한하는 편이 안전하다.

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

===== Help =====
+++ rustup --help |
<code text>
로컬 실행 파일이 없어 live output을 수집하지 않았다.
rustup --help
rustup help toolchain
</code>
+++

===== See Also =====
  * [[rust:ko]]
  * [[rust:rustc:ko]]
  * [[rust:cargo:ko]]
  * [[https://rust-lang.github.io/rustup/|The rustup book]]

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

{{indexmenu>.#1|js}}