rustup

Rust 工具链管理器

补充说明

rustup 安装和切换 Rust 工具链（stable/beta/nightly）、组件和目标平台，并提供 cargo、rustc 等命令的代理。它让同一台机器可以并存多个版本。

常用示例

rustup show
rustup toolchain install stable
rustup toolchain install nightly
rustup default stable
rustup override set nightly
rustup component add clippy rustfmt
rustup target add x86_64-unknown-linux-musl
rustup update
rustup self update
rustup run nightly cargo build
rustup which cargo

易错点与排错

• rustup default 是全局设置；项目级切换用 rustup override 或 rust-toolchain.toml。
• 组件是按工具链安装的；在 stable 装了 clippy，切到 nightly 可能没有。
• cargo/rustc 实际是 rustup 的代理；PATH 顺序不对会调用到别的版本。
• nightly 专属特性不能直接在 stable 上构建；CI 要固定工具链。
• 交叉编译还要装目标标准库和链接器；只 target add 不够。
• 镜像和代理配置影响下载；公司网络下先确认 RUSTUP_DIST_SERVER。
• 卸载工具链不会自动清理项目缓存；target/ 需要单独处理。
• 升级后先跑完整测试；编译器行为和新 lint 可能让旧代码失败。

相关命令

• cargo — 项目构建
• rustc — 编译器