rustup în Rust

Cargo și rustup rustup 1.0

Instalează și actualizează Rust: compilatorul, Cargo și componentele lor, în mai multe versiuni (stable, beta, nightly) și pentru mai multe sisteme.

Sintaxă
rustup update                       # actualizează Rust la ultima versiune
rustup show                         # ce versiuni și ținte sunt instalate
rustup toolchain install nightly
rustup default stable
rustup component add clippy rustfmt
rustup target add wasm32-unknown-unknown
rustup doc --std

Ce face rustup

rustup este instalatorul oficial al lui Rust. Se instalează o singură dată (de pe rustup.rs, cu curl ... | sh pe Linux și macOS sau cu rustup-init.exe pe Windows) și aduce rustc, cargo, biblioteca standard, documentația offline, rustfmt și clippy. O versiune nouă de Rust stable apare la fiecare șase săptămâni; rustup update o instalează.

Un toolchain este o versiune completă de Rust: stable, beta, nightly sau un număr exact (1.85.0). Poți avea mai multe; rustup default alege versiunea implicită, cargo +nightly build folosește alta pentru o singură comandă, iar un fișier rust-toolchain.toml fixează versiunea pentru un proiect.

Componentele (clippy, rustfmt, rust-src, rust-analyzer) se adaugă cu rustup component add. Țintele (biblioteca standard pentru alte sisteme, de exemplu Windows sau WebAssembly) se adaugă cu rustup target add, apoi compilezi cu cargo build --target ....

Parametri

Parametru Descriere
update Actualizează toolchain-urile instalate și rustup însuși.
show Afișează toolchain-ul activ, cele instalate și țintele.
toolchain install/uninstall Instalează sau șterge o versiune.
default Alege toolchain-ul implicit.
component add Adaugă o componentă (clippy, rustfmt, rust-src…).
target add Adaugă biblioteca standard pentru alt sistem.
check Verifică dacă există actualizări, fără să instaleze nimic.

Exemple

Exemplul 1: Ce este instalat și dacă există actualizări

rustup show arată toolchain-ul activ și țintele instalate. rustup check anunță că există o versiune nouă, pe care rustup update ar instala-o.

$ rustup show
$ rustup check
$ rustc --version

Rezultat în terminal

Default host: x86_64-unknown-linux-gnu
rustup home:  /home/ana/.rustup

installed toolchains
--------------------
stable-x86_64-unknown-linux-gnu (active, default)

active toolchain
----------------
name: stable-x86_64-unknown-linux-gnu
active because: it's the default toolchain
installed targets:
  x86_64-unknown-linux-gnu
  wasm32-unknown-unknown

stable-x86_64-unknown-linux-gnu - update available: 1.99.0 (b940084d7 2026-09-28) -> 1.99.1 (58cf8f9c3 2026-10-13)
rustup - up to date : 1.29.1
rustc 1.99.0 (b940084d7 2026-09-28)

Exemplul 2: Componente și ținte instalate

Lista componentelor instalate pentru toolchain-ul activ. rust-std apare o dată pentru fiecare țintă (sistem) pentru care poți compila.

$ rustup component list --installed

Rezultat în terminal

cargo-x86_64-unknown-linux-gnu
clippy-x86_64-unknown-linux-gnu
rust-docs-x86_64-unknown-linux-gnu
rust-std-wasm32-unknown-unknown
rust-std-x86_64-unknown-linux-gnu
rustc-x86_64-unknown-linux-gnu
rustfmt-x86_64-unknown-linux-gnu

Greșeli frecvente

  • Instalezi Rust din managerul de pachete al distribuției (apt install rustc) și primești o versiune veche, fără rustup. Pentru dezvoltare folosește rustup.
  • Compilezi pentru altă țintă fără rustup target add: can't find crate for `std` / the `...` target may not be installed.
  • Folosești funcționalități nightly (#![feature(...)]) într-un proiect care trebuie să meargă pe stable. Ele pot dispărea sau se pot schimba oricând.

Comenzi înrudite

  • cargo new: Creează un proiect Rust nou: directorul, Cargo.toml, src/main.rs (sau src/lib.rs) și un depozit git.
  • cargo build: Compilează proiectul și dependențele lui. Executabilul ajunge în target/debug/ sau, cu –release, optimizat în target/release/.
  • cargo fmt: Formatează automat tot codul proiectului după stilul oficial Rust (indentare, spații, acolade), cu rustfmt.
  • cargo clippy: Analizează codul cu sute de reguli (lints) și semnalează greșeli frecvente, cod ineficient sau neidiomatic, cu sugestii de corectare.
  • cargo doc: Generează documentația HTML a proiectului din comentariile ///, cu toate tipurile și funcțiile publice, ca pe docs.rs.