The Rust toolchain

# rustup, the release channels, and cargo as the single front door — the catalog of built-in and companion tools from rustc to miri.

❯ cat documents/

The Rust toolchain Concept 2026-08-09
rustup, the release channels, and cargo as the single front door — the catalog of built-in and companion tools from rustc to miri.
cargo — the front door Concept 2026-08-09
The daily interface to everything — build/run/test/bench/doc, dependency management with cargo add, the cargo-* plugin convention, and what each command actually does.
cargo-expand — macro expansion Concept 2026-08-09
Prints your code with all macros and derives expanded — the essential debugging view for proc-macro-heavy code, powered by nightly rustc's -Zunpretty.
cargo-nextest — the test runner Concept 2026-08-09
The community-standard test runner — process-per-test isolation, cleaner output, flaky-test retries, CI partitioning and JUnit reports — and what it doesn't run (doctests).
clippy — the lint collection Concept 2026-08-09
Rust's official linter — 750+ lints in leveled categories from correctness to pedantic, cargo clippy --fix, clippy.toml, and sane CI policy.
miri — undefined-behaviour detection Concept 2026-08-09
The MIR interpreter that catches undefined behaviour in unsafe code — aliasing-model violations, use-after-free, data races — as a nightly component run under cargo miri test.
Profiling & debugging Rust Concept 2026-08-09
The profiling and debugging story — perf and cargo-flamegraph, samply, debug info in release builds, rust-gdb/rust-lldb, heap tools, and tokio-console for async.
rust-analyzer — the language server Concept 2026-08-09
The official LSP server — on-the-fly analysis, proc-macro expansion, assists and inlay hints, flychecks via cargo check, and configuration worth knowing.
rustc — the compiler behind cargo Concept 2026-08-09
The compilation pipeline — HIR/MIR, borrow checking, monomorphization, LLVM codegen — and the knobs that matter: codegen units, incremental builds, lints, error codes.
rustdoc & docs.rs — documentation Concept 2026-08-09
Doc comments to rendered API docs — doctests that actually run, intra-doc links, feature-flagged docs, and docs.rs building every crates.io release automatically.
rustfmt — formatting Concept 2026-08-09
Canonical formatting as a rustup component — cargo fmt, the rustfmt.toml escape hatch, stable vs nightly-only options, and the CI check.
rustup — toolchain management & the release channels Concept 2026-08-09
The toolchain multiplexer — stable/beta/nightly channels, components, cross-compilation targets, and per-project pinning via rust-toolchain.toml.