bash
rustup toolchain listNotes
Shows installed toolchains and which one is active.
Rust CLI rustup, Toolchains, Components, and Targets
Manage Rust toolchains with rustup, switch channels, install components, and add cross-compilation targets.
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
Toolchains
Install, list, and switch between stable, beta, nightly, and custom toolchains.
bash
rustup toolchain install nightlyNotes
Nightly is commonly used for unstable features or tooling experiments.
bash
rustup toolchain install betaNotes
Beta helps verify compatibility before stable releases.
bash
rustup default nightlyNotes
Applies outside directories that have overrides or rust-toolchain files.
Pin a toolchain in one directory
Create a directory override for the current folder.
bashANYrustupoverride
bash
rustup override set stableNotes
Directory overrides let a project use a different toolchain than global default.
bash
rustup override unsetNotes
Use this when a project no longer needs a local override.
rust-toolchain files
Commit toolchain choices to the repository.
Pin toolchain in version-controlled config
Check in a `rust-toolchain.toml` file.
tomlANYrustuptoolchaintoml
toml
[toolchain]
channel = "stable"
components = ["rustfmt", "clippy"]
targets = ["x86_64-unknown-linux-musl"]Notes
A rust-toolchain file can pin channel, components, and targets for a repo.
Use stable once without changing defaults
Run one command on the stable toolchain.
bashANYcargorustuptoolchain
bash
cargo +stable testNotes
The `+toolchain` shorthand overrides the toolchain for that invocation.
Components
Install rustfmt, Clippy, docs, and source code components.
List components
Show installed and available components for active toolchain.
bashANYrustupcomponentlist
bash
rustup component listNotes
Useful for seeing whether rustfmt or clippy is already available.
bash
rustup component add rustfmtNotes
Required before running `cargo fmt` on some toolchains.
bash
rustup component add clippyNotes
Required before running `cargo clippy`.
bash
rustup component add rust-srcNotes
Needed by some IDEs, tools, and advanced workflows.
bash
rustup docNotes
Convenient for offline browsing of docs.
Targets and cross-compilation
Add platform targets and build for different target triples.
bash
rustup target listNotes
Includes installed status for each target.
bash
rustup target add x86_64-unknown-linux-muslNotes
You must usually add the target before cross-compiling to it.
bash
rustup target add aarch64-apple-darwinNotes
Useful when cross-building or producing release artifacts for macOS ARM.
bash
cargo build --target x86_64-unknown-linux-muslNotes
Target-specific artifacts are stored under `target/<triple>/...`.
Run is typically host-only
Build target-specific binaries for packaging instead of running them locally.
bashANYcargotargetcross
bash
cargo build --target aarch64-apple-darwinNotes
Cross-target binaries usually cannot be executed directly on the host unless compatible.
More in Rust CLI
Rust CLI Troubleshooting: CI, Environment, Build Scripts, and Publishing
Commands for debugging CI failures, environment mismatches, build script output, installation problems, and publish checks in Rust CLI projects.
Rust CLI Troubleshooting: rustup, Toolchains, Components, and Targets
Commands for fixing toolchain mismatches, missing components, and cross-compilation target issues in Rust CLI projects.
Rust CLI Troubleshooting: Tests, Doctests, and Documentation
Commands for debugging failing tests, capturing output, isolating flaky cases, and fixing documentation-generation issues in Rust CLI projects.
Rust CLI Troubleshooting: Dependencies, Features, and Lockfiles
Commands for analyzing dependency trees, feature activation, duplicate crates, and lockfile behavior in Rust CLI projects.
Rust CLI Troubleshooting: Manifest, Packages, and Workspaces
Commands and examples for debugging Cargo.toml issues, package selection mistakes, and workspace confusion in Rust CLI repos.
Rust CLI Troubleshooting: Build Errors and Diagnostics
Commands for investigating compiler errors, Cargo diagnostics, verbose output, and fix suggestions in Rust CLI projects.