Show active toolchain details
Display installed toolchains and the active default.
bashANYrustuptoolchainsshow
bash
rustup showNotes
A first step when builds behave differently than expected across machines or CI.
Rust CLI Troubleshooting: rustup, Toolchains, Components, and Targets
Commands for fixing toolchain mismatches, missing components, and cross-compilation target issues in Rust CLI projects.
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
Toolchain selection
Verify which compiler and channel Cargo is using.
bash
rustup default stableNotes
Useful when a machine accidentally defaults to nightly or an older channel.
Run Cargo with a specific toolchain
Use a channel explicitly for one command.
bashANYcargotoolchainstable
bash
cargo +stable testNotes
Good for confirming whether an issue is tied to a specific channel or toolchain version.
Pin a directory to one toolchain
Set a local override for the current project.
bashANYrustupoverride
bash
rustup override set stableNotes
Useful when a repository should always use one toolchain regardless of the machine default.
See which rustc binary is used
Show the actual executable path selected by rustup.
bashANYrustupwhichrustc
bash
rustup which rustcNotes
Helpful when PATH confusion or editor integration points to the wrong compiler binary.
Components and targets
Install missing tools like clippy or target triples for cross builds.
List installed and available components
See whether rustfmt, clippy, or docs are installed.
bashANYrustupcomponents
bash
rustup component listNotes
Useful when `cargo fmt` or `cargo clippy` fails because the component is missing.
bash
rustup component add clippyNotes
Required before using `cargo clippy` if the component is not already installed.
bash
rustup component add rustfmtNotes
Required before using `cargo fmt` if rustfmt is missing.
bash
rustup target list --installedNotes
Useful when cross-compilation fails because the intended target is not installed.
bash
rustup target add x86_64-unknown-linux-muslNotes
A common step when building static Linux binaries or cross-compiling from another host platform.
bash
cargo build --target x86_64-unknown-linux-muslNotes
Useful after adding the target with rustup and configuring any required linker or C toolchain pieces.
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: 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.
Rust CLI Cargo Config, Environment, Docs, and Debugging
Cargo configuration, environment variables, docs generation, and troubleshooting commands for Rust CLI development.