rustup & Gerenciamento de Toolchain
rustup instala e alterna toolchains do Rust, componentes (clippy, rustfmt) e targets de cross-compilação. É a forma suportada de gerenciar Rust em máquinas de desenvolvedores e CI.
//
Busque em todas as páginas da documentação
rustup instala e alterna toolchains do Rust, componentes (clippy, rustfmt) e targets de cross-compilação. É a forma suportada de gerenciar Rust em máquinas de desenvolvedores e CI.
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
rustup default stable
rustup toolchain install 1.97.0
rustup component add rustfmt clippy rust-analyzer
rustup target add wasm32-unknown-unknownQuando usar isso:
# rust-toolchain.toml (repo root)
[toolchain]
channel = "1.97.0"
components = ["rustfmt", "clippy"]
targets = ["x86_64-unknown-linux-gnu"]cd my-repo
rustc --version # 1.97.0 via override
cargo clippyO que isso demonstra:
rust-toolchain.toml seleciona automaticamente a toolchain no diretóriodtolnay/rust-toolchain| Canal | Uso |
|---|---|
stable | Alinhamento de MSRV de produção |
beta | Prévia do próximo stable |
nightly | Miri, recursos instáveis |
rustup set profile minimal em agentes de CI; default em laptops de desenvolvimento inclui rust-docs.
apt install rustc da distro - versão antiga. Correção: apenas rustup; remova o rust do apt.clippy não encontrado. Correção: rustup component add clippy.rust-toolchain.toml.rustup toolchain list e remova as antigas.| Alternativa | Use Quando | Não Use Quando |
|---|---|---|
| Nix flake | Shells de desenvolvimento reproduzíveis | Equipe não usa Nix |
| Imagem de dev Docker | CI/dev idêntica | Velocidade nativa do IDE preferida |
Plugin asdf para rust | Gerenciadores de versão poliglota | rustup padrão é suficiente |
rustup toolchain uninstall 1.75.0
Certifique-se de que o VS Code usa o componente rust-analyzer do rustup, não um binário autônomo incompatível.
O rust-toolchain.toml de cada repo é aplicado ao entrar no diretório (cd).
Versões de Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, e Polars 0.46+.
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026