罗罗编程学习记录
本页内容 展开查看

11.1 阶段 0 工具链与开发环境

所属:全栈开发面试题库 / 学习路径 / 11 Rust 全栈

本页目录

一、阶段定位

阶段 0 只解决一件事:在本机把 Rust 工具链装好、认得出 cargo 在做什么、能把第一段 cargo run 跑起来。它不教你写 Rust 代码——语法属于阶段 1——但它要把后面四个阶段会反复用到的「外壳」先钉死:rustup 通道、组件、cargo 子命令、Edition、MSRV、目标三元组、离线与代理。

为什么这件事不能跳过去:Rust 的工具链比 C/C++ 复杂得多。你不是装一个 gcc,而是装一个能在 stable / beta / nightly 之间切换、能按目录自动选工具链、能为多个目标三元组交叉编译、还附带 clippy 与 rustfmt 两个强制工具的管理器。第一次建工程时,新人最常卡住的不是所有权,而是:cargo new 出来的 Cargo.toml 里 edition = "2021" 是什么意思?为什么 cargo build 要 30 秒、cargo check 只要 3 秒?为什么 rust-analyzer 在 IDE 里报红、但 cargo check 通过?为什么国内网络下 cargo build 在拉依赖阶段卡住?

本阶段与前后阶段的衔接:往上承接本篇总览页对读者的假设(会用命令行、会用 Git);往下交给阶段 1 去写变量、类型与函数。如果你在阶段 1 写的每一行代码都要先解决「为什么 nightly 才能用这个语法」「为什么这个 crate 在我的 stable 上编译失败」,阶段 1 的节奏会被完全打乱。所以本阶段的硬指标是:任何一个阶段 1 的示例都应当能在本机一次 cargo run 跑通,而不需要临时改工具链。

「卡点」判断标准:如果看到下面任一现象,说明阶段 0 没结束,不要进阶段 1——

  • rustup show 无法一眼看出当前目录用的是哪条通道、哪个 host 三元组;
  • 把 cargo build、cargo check、cargo clippy 三者当成同义词在用;
  • 不知道 Cargo.toml 里 edition 字段的作用,遇到 Edition 2024 报「保留关键字 gen」时完全不知道为什么;
  • 第一次引入第三方 crate 时,必须临时改 ~/.cargo/config.toml 才能把依赖拉下来;
  • 无法解释「为什么生产上推荐用 release 构建、为什么 debug 构建整数会 panic」。

二、阶段目标与投入

学完本页,应当能用可观察的行为证明以下能力,而不是「装过 Rust 教程」:

能力目标(可验证的行为) 验证方式
能用 rustup 安装 stable,并用 rustup override 在一个目录切到 nightly、再用 rust-toolchain.toml 固化 在该目录 rustup show 输出 nightly;切到别的目录恢复 stable
能解释 cargo build、cargo check、cargo clippy、cargo fmt、cargo test、cargo doc 各自做什么、为什么 check 最快 同一段代码跑 cargo check 与 cargo build,对比耗时与产物
能读懂 Cargo.toml 的 edition、rust-version、[dependencies]、[profile] 字段 能给一个空白工程加上 rust-version = "1.75" 并在更老的工具链上看到明确报错
能说出 Edition 2021 与 2024 之间的至少四处确定差异,并定位到自己项目用的是哪一档 写出 gen 作为变量名在 2021 下能编译、在 2024 下报错
能为国内网络环境配置 crates.io 镜像与 http.proxy 断网后用 cargo build --offline 仍能编译已缓存依赖
能用 rustup target add 为一个常见目标(如 x86_64-pc-windows-msvc 之外的 x86_64-unknown-linux-gnu)做一次交叉编译 cargo build --target <triple> 产出该目标的可执行文件

建议学时:

  • 全职(每天有效学习 4–6 小时):2–3 天,约 10–14 小时。以「装环境 + 跑通示例 + 把每个子命令都试一遍」为节奏,不要在某条命令的细节上死磕。
  • 在职(每天 1.5–2 小时):1 周,约 10 小时。把每个模块拆成一个晚上,周末统一做一次交叉编译与离线实验。

学时分配建议:rustup 与通道 20%、cargo 子命令与工程骨架 25%、Edition 与 MSRV 15%、依赖管理(cargo tree / update / metadata)15%、离线与代理 10%、目标三元组与交叉编译 10%、dbg! 与调试 5%。依赖管理与离线代理是国内开发者的真实痛点,时间要给够。

三、先修自检

进入本阶段前,逐条自检;任何一条做不到,先补对应通用能力再开始。

先修项 合格标准 不合格时回到
命令行操作 能在终端里 cd、ls/dir、查看文件内容、看懂绝对路径与相对路径 01 计算机基础与通用工程
包管理直觉 用过 apt、brew、npm、pip 中至少一个,知道「声明依赖 → 拉取 → 锁版本」三段式 01 计算机基础与通用工程
Git 基本操作 能 git init、git add、git commit,看懂 git status 01 计算机基础与通用工程
编译与运行 知道「源码 → 编译器 → 可执行文件」三段,分得清 debug 与 release 01 计算机基础与通用工程
环境变量与网络代理 知道 HTTP_PROXY、HTTPS_PROXY 这类变量的作用,能在公司代理下让 curl 走通 01 计算机基础与通用工程

另有一条经验判断:如果你之前一直在用 Java(Maven/Gradle)或 Go(go mod),cargo 的心智模型与它们最接近——声明依赖、锁文件、workspace。如果你之前只用过 npm / yarn,会对「Rust 的依赖图为什么动辄上百个 crate」产生不适应,但这不是 bug:Rust 没有「标准库大而全」的传统,哈希、时间、序列化往往各自是一个独立 crate。

四、知识地图

「掌握程度」分三档:了解(知道有这个东西、能查到)、会用(能写对、能调通)、能讲清原理(能解释底层结构与边界条件、能回答追问)。本阶段的目标分布如下。

模块 知识点 掌握程度 对应题库章节
rustup 与通道 stable / beta / nightly、rustup override、rust-toolchain.toml、rustup show 会用 04.4 Rust
组件管理 rustup component add clippy rustfmt rust-analyzer、rustup component list 会用 04.4 Rust
cargo 子命令 new / build / run / check / test / clippy / fmt / doc、profile 能讲清原理 04.4 Rust
Edition 与 MSRV edition = "2021" / "2024"、rust-version、RPIT 捕获、保留关键字 会用 04.4 Rust
依赖管理 cargo tree、cargo update、Cargo.lock、cargo metadata 会用 04.4 Rust
离线与代理 CARGO_HOME、~/.cargo/config.toml、http.proxy、cargo build --offline 会用 04.4 Rust
目标三元组 rustup target list、rustup target add、cargo build --target 了解 04.4 Rust
调试输出 dbg! 宏、eprintln!、RUST_BACKTRACE=1 会用 04.4 Rust

进度管理建议:把这张表复制到自己的笔记里,每学完一个模块把「掌握程度」往下调一档;三档都到位再进阶段 1。《知识点全清单》是本篇更细的全量清单,与此表的分工是「全量打勾」与「本阶段重点」。

五、分模块精讲

5.1 rustup 通道与目录级工具链选择

为什么需要它:Rust 不像 C 那样「装一个 gcc 就是 gcc」,它同时维护三条发布通道,并且允许你在不同目录用不同通道。不理解这一点,就会出现「我在家里编译通过,到了公司报错」「这个示例我抄的,为什么提示需要 nightly」这类无法解释的现象。

核心机制:

  • 三条通道:stable(每 6 周发版、面向生产)、beta(下一个 stable 的预览)、nightly(每日构建、只允许用 unstable feature)。
  • rustup 是工具链管理器,不是编译器本身。它根据当前目录选择要激活的工具链:优先级是 rustup override set 设置的目录覆盖 → 目录下 rust-toolchain.toml 文件 → RUSTUP_TOOLCHAIN 环境变量 → 默认工具链。
  • rust-toolchain.toml 是仓库级别的固化文件,应当提交到 Git;这样团队任何人 clone 下来都会用同一通道。
  • rustup show 是排障第一命令:它会列出已安装的所有工具链、当前目录选中的是哪条、host 三元组是什么。

最小可运行示例:

# 安装 stable(国内网络建议先设镜像,见 5.6)
rustup install stable
rustup default stable

# 在一个实验目录里切到 nightly
mkdir nightly-lab && cd nightly-lab
rustup override set nightly
rustup show            # 这里应当显示 nightly 被本目录覆盖

# 用 rust-toolchain.toml 固化,提交到 Git
cat > rust-toolchain.toml <<'EOF'
[toolchain]
channel = "nightly-2025-01-15"
components = ["rustfmt", "clippy", "rust-analyzer"]
targets = ["x86_64-unknown-linux-gnu"]
EOF
rustup show            # 现在锁定到具体日期的 nightly,不会自动漂移

常见坑:

现象 原因 修法
error[E0635]: unknown feature 用 stable 编译 nightly-only 代码 切到 nightly 或改用 stable 等价写法
团队成员 rustup show 输出不一致 仓库没有 rust-toolchain.toml,各自默认工具链不同 提交 rust-toolchain.toml 到仓库
rustup override list 积累一堆目录 用了 override 但没清理 rustup override unset 清理当前目录覆盖
nightly 自动飘移,CI 昨天过今天挂 没写死 nightly 日期 在 rust-toolchain.toml 中用 nightly-YYYY-MM-DD

面试考法:常见问法是「stable、beta、nightly 有什么区别,为什么生产不用 nightly」。答到「stable 是 6 周一轮的冻结版本,API 与行为稳定;nightly 是日构建,只用来试 unstable feature,随时间漂移,不能作为生产基线」。追问常落在「rust-toolchain.toml 与 rustup override 的优先级」与「为什么 nightly 要钉日期」。

5.2 组件管理:clippy、rustfmt、rust-analyzer

为什么需要它:Rust 把代码质量工具从编译器里拆出来做成「组件」。clippy 是 lint 集合,rustfmt 是格式化,rust-analyzer 是 LSP。三者缺一个,IDE 体验或 CI 就会瘸腿。

核心机制:

  • rustup component list 列出所有组件及其是否已安装;rustup component add <name> 安装。
  • clippy 不是 cargo build 的替代,而是独立的 lint 集合:cargo clippy 在编译过的基础上跑规则,cargo clippy -- -D warnings 把 warning 当错误。
  • rustfmt 是唯一的官方格式化工具;cargo fmt 会递归格式化整个 crate,cargo fmt -- --check 用于 CI 检查是否有未格式化的代码。
  • rust-analyzer 是 IDE 后端(VS Code、JetBrains、Neovim 都用它),它依赖 cargo 元数据;如果 IDE 里标红但 cargo check 通过,先怀疑 rust-analyzer 没拿到正确工具链。
  • rust-src 组件让 rust-analyzer 能跳转到标准库源码;没有它,IDE 里看 Vec::push 的实现会一片空白。

最小可运行示例:

# 一次装齐三个常用组件
rustup component add clippy rustfmt rust-analyzer rust-src

# 在工程目录里分别跑
cargo fmt                          # 自动按 rustfmt 规则格式化
cargo fmt -- --check               # CI 用:不通过就退出非零
cargo clippy                       # 跑 lint,输出 warning
cargo clippy -- -D warnings        # 把所有 clippy warning 升级为错误
cargo doc --open                   # 生成本 crate 的文档并在浏览器打开
# Cargo.toml 中可以为 workspace 统一禁用某些 lint
[workspace.metadata]
# rustfmt 默认风格即可;clippy 的配置放在 .clippy.toml

常见坑:

现象 原因 修法
VS Code 里 rust-analyzer failed to discover workspace rust-analyzer 没装或工具链没选对 rustup component add rust-analyzer,在 VS Code 里选对工具链
cargo clippy 输出与 cargo build 不一致 clippy 有自己的缓存,与 build 缓存分开 cargo clean 后重跑,或 cargo clippy 会自动触发重编译
cargo fmt 把团队代码改得一团糟 没有 .rustfmt.toml 且团队成员 rustfmt 版本不同 在仓库根加 .rustfmt.toml,并在 rust-toolchain.toml 钉 rustfmt 版本
IDE 里跳不到标准库源码 没装 rust-src rustup component add rust-src

面试考法:常问「clippy 与 cargo build 的 warning 有什么区别」。答到「cargo build 的 warning 是编译器自己发现的语言级问题;clippy 是在编译产物上跑的额外 lint 规则集合,覆盖风格、效率、误用 API」。追问会问「为什么 CI 里要 -D warnings」,答案是「防止 lint 警告随时间腐烂,让新引入的坏味道第一时间被挡住」。

5.3 cargo 子命令与工程骨架

为什么需要它:cargo 是 Rust 的构建工具与包管理器二合一。cargo build 与 cargo check 的差别,直接决定你日常反馈周期是 3 秒还是 30 秒;Cargo.toml 的 profile 配置决定你生产包的体积与性能。

核心机制:

  • cargo new <name> 生成二进制 crate(有 src/main.rs);cargo new --lib <name> 生成库 crate(有 src/lib.rs)。cargo new --vcs none 跳过 Git 初始化。
  • cargo build 编译出可执行文件到 target/debug/;cargo build --release 用 release profile 编译到 target/release/。
  • cargo check 只做类型检查与借用检查,不生成机器码,所以比 build 快一个数量级。日常改代码优先用 cargo check,最后一次 cargo build 验证可执行产物。
  • cargo run 等于「先 check 再 build 再执行」;cargo test 编译并跑测试;cargo doc 生成文档。
  • [profile.dev] 默认开启 debug 信息与 overflow-checks = true;[profile.release] 默认 opt-level = 3、overflow-checks = false、debug = false。
  • Cargo.lock 对二进制 crate 应当提交,对库 crate 不提交。

最小可运行示例:

# 第一段工程
cargo new hello-rust --vcs none
cd hello-rust

cargo check                 # 秒级反馈
cargo run                   # 输出 Hello, world!
cargo run -- --name Ann     # -- 后面是传给程序的参数

# 加一个第三方依赖
cargo add serde --features derive
# 这会把 serde = { version = "1.0", features = ["derive"] } 写进 Cargo.toml
// src/main.rs
fn main() {
    let name = std::env::args().nth(1).unwrap_or_else(|| "world".to_string());
    println!("Hello, {name}!");
    // dbg! 是带文件行号的调试输出,会 ownership 移动再归还,适合临时插桩
    dbg!(&name);
}
# Cargo.toml
[package]
name = "hello-rust"
version = "0.1.0"
edition = "2021"
rust-version = "1.75"

[dependencies]
serde = { version = "1.0", features = ["derive"] }

[profile.release]
opt-level = 3
debug = false
lto = "thin"

常见坑:

现象 原因 修法
cargo build 第一次很慢,第二次很快 cargo 把依赖缓存在 target/ 与 ~/.cargo/registry 不要每次 cargo clean;只有怀疑缓存损坏才清
cargo run 跑的是旧代码 编辑后没保存或 cargo 缓存判断错误 保存后再跑;异常时 touch src/main.rs 触发重编译
error: linking with link.exe failed Windows 上没装 MSVC Build Tools 或 GNU 工具链 装 Visual Studio Build Tools,或切 x86_64-pc-windows-gnu
生产包体积巨大 release profile 没关 debug、没开 strip [profile.release] debug = false、strip = true

面试考法:高频题是「cargo check 为什么比 cargo build 快」。答到「check 只做 HIR 与借用检查,不做 codegen 与 LLVM 优化;LLVM 这一步在 release 构建里占大头」。追问常落在「debug 与 release 的整数溢出行为差异」——debug 下 i32::MAX + 1 会 panic,release 下静默回绕,因为 overflow-checks 默认随 profile 翻转。

5.4 Edition 2021 与 2024 的确定差异

为什么需要它:Edition 是 Rust 解决「语言演进不能破坏旧代码」的机制。同一个 rustc 能编译多个 Edition 的 crate,它们之间可以互相调用。但 Edition 之间不是「语法糖升级」,有些差异是破坏性的、编译行为变化的。写错了要么编译失败,要么运行时语义变了。

核心机制:

  • edition = "2015" / "2018" / "2021" / "2024" 是四个已发布 Edition;Cargo.toml 里不写时默认 2015(新项目已强制 2021 起)。
  • Edition 2021 相对 2018 主要是:cargo 新解析器、IntoIterator for arrays、prelude 加入 TryInto、闭环的 BTreeMap 错误提示。
  • Edition 2024 相对 2021 的确定差异(面试常考):
    1. RPIT(impl Trait)生命周期捕获规则改变:2021 下 impl Trait 在函数返回位置会捕获所有输入生命周期;2024 下改为「按使用捕获」,类似 rust 的 dyn 行为。这影响「返回 impl Future 能不能跨 await」。
    2. unsafe extern:2024 起 extern "C" fn 默认必须显式写 safe 或 unsafe,区分「FFI 函数本身是否安全调用」。
    3. &raw 语法:可以在 safe 上下文里用 &raw const x / &raw mut x 创建裸指针而不触发未定义行为。
    4. 保留关键字 gen:2024 起 gen 是为未来 generator 预留的关键字,不能再作普通变量名。
    5. match ergonomics 保留:match 中对引用的自动解引用规则保持不变,没有破坏性。
  • Edition 之间可以通过 #[edition = "..."] 内联模块在同一个 crate 里混用,但日常项目应当统一。

最小可运行示例:

// 在 edition = "2021" 下能编译;把 Cargo.toml 改成 "2024" 后这一行报错
fn main() {
    let gen = 42;   // error: expected identifier, found keyword `gen`
    println!("{gen}");
}
// unsafe extern 在 2024 下必须显式标注
// 2021: extern "C" fn foo() {}
// 2024: safe extern "C" fn foo() {}   // 或 unsafe extern "C" fn foo() {}

常见坑:

现象 原因 修法
error: expected identifier, found keyword gen`` 用 2024 编译旧代码 改回 2021,或把 gen 改名为 gen_value
返回 impl Future 在 await 后借用失效 2021 的 RPIT 捕获规则与 2024 不同 显式加生命周期,或把整个工程切到 2024
extern "C" 函数突然要求 safe/unsafe 前缀 切到 2024 后 FFI 语法变了 按函数是否安全调用显式标注
老 crate 依赖 edition 2015 的 API,新项目 2024 调用报错 Edition 间类型不兼容 在调用处加 Box::pin 或显式生命周期适配

面试考法:常问「Rust 的 Edition 与 GCC 的版本号有什么区别」。答到「Edition 是语言级别的不向后兼容开关,同一个 rustc 能同时编译多个 Edition 的 crate;GCC 版本是工具链升级,旧代码在新 GCC 上要么通过要么警告,不存在『同一编译器支持多套语言语义』」。追问会问「为什么不直接破坏性升级,而要分 Edition」,答案是「避免生态分裂——10 年前写的 crate 仍能在今天的 rustc 上编译,不需要重写」。

5.5 MSRV 与 rust-version 字段

为什么需要它:你发布的库不能要求用户装最新 nightly,但你自己也想用 6 个月前的新 API。rust-version 字段(Minimum Supported Rust Version)就是给用户看的「我这个 crate 至少要哪个 rustc 才能编译」。

核心机制:

  • Cargo.toml 的 rust-version = "1.75" 表示本 crate 最低支持 1.75。
  • 如果用户用更老的 rustc 编译,cargo 会直接报 rustc 1.70.0 is not supported by the following packages,而不是让用户在数百行编译错误里猜。
  • MSRV 是一个承诺:你不能在 1.75 的 MSRV 下偷偷用 1.78 才加的 API。CI 里通常要单独跑一个 MSRV job,用旧工具链编译一遍。
  • 提升 MSRV 是一个 semver 级别的决策:保守的库会在 minor 版本提升 MSRV,激进的库会在 major 版本提升。
  • cargo msrv(第三方工具)可以二分查找一个历史版本的 crate 需要哪个 MSRV。

最小可运行示例:

# Cargo.toml
[package]
name = "my-lib"
version = "0.3.1"
edition = "2021"
rust-version = "1.75"   # 用户装 1.75 或更新即可
# 用一个明显更老的工具链试编译,验证 rust-version 生效
rustup install 1.70.0
rustup run 1.70.0 cargo build
# 期望输出:error: rustc 1.70.0 is not supported by the following packages

常见坑:

现象 原因 修法
error: use of unstable library feature 用了 nightly-only API 但 MSRV 写的是 stable 改用 stable API,或把 MSRV 改成 nightly
本地编译通过、CI 用 MSRV 工具链挂掉 本地用了新版 rustc,MSRV 工具链没有对应 API 加 MSRV job;用 #[cfg] 或 dyn 回退
用户报「在 rustc 1.75 上编译失败」 依赖了某个传递依赖的新版 API 锁定传递依赖的版本,或提升 MSRV 并说明

面试考法:常问「为什么需要 MSRV,直接要求用户装最新 rustc 不行吗」。答到「Rust 工具链升级在企业环境里不是一键的,服务器、CI、嵌入式工具链都可能滞后;MSRV 是库作者给下游的兼容承诺」。追问会问「MSRV 提升在 semver 上算 major 还是 minor」,答案没有标准答案,主流库通常在 minor 提升并在 CHANGELOG 显著标注。

5.6 依赖管理:cargo tree、update、metadata、离线与代理

为什么需要它:Rust 的依赖图动辄上百个 crate。serde 一个 crate 看起来简单,实际拉下来会带 serde_core、serde_derive 等。国内网络下 crates.io 默认源经常超时;企业内网根本访问不了外网。不掌握这一节,你会在「拉依赖」这一步卡掉一半时间。

核心机制:

  • Cargo.lock 是锁文件,记录每个依赖的精确版本与哈希。cargo build 不指定更新策略时按 lock 走;cargo update 把所有依赖升到 semver 允许的最新。
  • cargo update -p serde --precise 1.0.200 只升级 serde 到指定版本,用于修复 CVE。
  • cargo tree 打印依赖树;cargo tree -i serde 反向查「谁依赖了 serde」;cargo tree -e features 看 features 如何启用。
  • cargo metadata --format-version 1 输出 JSON,给 IDE、cargo audit、rust-analyzer 这类工具消费。
  • CARGO_HOME 环境变量决定 cargo 把 registry 缓存、二进制缓存放哪;默认在用户目录下的 .cargo。
  • ~/.cargo/config.toml(或仓库内 .cargo/config.toml)配置镜像源与代理:
    • [source.crates-io] replace-with = "mirror" 替换默认源;
    • [http] proxy = "http://127.0.0.1:7890" 走 HTTP 代理;
    • [net] git-fetch-with-cli = true 用系统 git 拉 git 依赖。
  • cargo build --offline 完全不访问网络,只用本地缓存;适合 CI 与内网。

最小可运行示例:

# ~/.cargo/config.toml(用户级,全局生效)
[source.crates-io]
replace-with = "rsproxy-sparse"

[source.rsproxy-sparse]
registry = "sparse+https://rsproxy.cn/index/"

[registries.rsproxy]
index = "sparse+https://rsproxy.cn/index/"

[http]
proxy = "http://127.0.0.1:7890"    # 公司代理或本地代理,按需打开
timeout = "60s"

[net]
git-fetch-with-cli = true
cargo tree | head -30                  # 看顶层依赖树
cargo tree -i serde                    # 谁依赖了 serde
cargo update -p serde --precise 1.0.200
cargo build --offline                  # 断网也能编译已缓存依赖

常见坑:

现象 原因 修法
error: failed to download from https://crates.io/...`` 网络访问 crates.io 超时 配镜像源或 [http] proxy
cargo build 在公司内网完全跑不动 没配内网 mirror 用内网源替换 crates-io
cargo tree 出现两个版本的同一 crate 不同依赖要求的 semver 区间不兼容 用 cargo tree -d 看重复;协调升级
改了 Cargo.toml 但 cargo build 没反应 没删 lock 或 lock 已经锁定旧版 cargo update -p <name>,或删 Cargo.lock 重建
cargo metadata 输出巨大且慢 首次生成或 workspace 大 缓存到 target/,配合 rust-analyzer 使用

面试考法:常问「Cargo.lock 为什么二进制项目要提交、库项目不提交」。答到「二进制项目要可复现构建,所有人 clone 下来拿到同一版依赖;库项目要让下游能吃到 semver 允许的最新版,锁文件会限制下游」。追问会问「sparse index 与老式 git index 的区别」,答案是「sparse 只拉取你真正查询的 crate 索引条目,比老式 git clone 整个 index 快几个数量级,是 2023 年后 crates.io 的默认协议」。

5.7 目标三元组与交叉编译

为什么需要它:Rust 部署目标不止你正在用的操作系统。你可能在 Windows 上编译出 Linux 可执行文件放到服务器,也可能在 x86 开发机上编译出 ARM 嵌入式固件。rustup target add 是第一步,但交叉编译往往还需要 C 工具链与系统库配合。

核心机制:

  • 目标三元组(target triple)形如 x86_64-pc-windows-msvc、aarch64-unknown-linux-gnu、wasm32-unknown-unknown,三段分别是 CPU 架构、厂商、操作系统/ABI。
  • rustup target list --installed 列出已装的目标;rustup target add <triple> 装新目标的标准库。
  • cargo build --target <triple> 为该目标编译。
  • 交叉编译时 Rust 标准库能解决,但依赖 C 的 crate(如 openssl、libz)需要你额外装对应的交叉 C 工具链与 sysroot。
  • wasm32-unknown-unknown 是 Rust 编译到 WASM 的默认目标,与 wasm-bindgen、wasm-pack 配套。

最小可运行示例:

# 看本机 host 三元组
rustc -vV | grep host

# 为 Linux GNU 装一个目标(在 Windows 上)
rustup target add x86_64-unknown-linux-gnu
cargo build --target x86_64-unknown-linux-gnu

# WASM 目标
rustup target add wasm32-unknown-unknown
cargo build --target wasm32-unknown-unknown

常见坑:

现象 原因 修法
error[E0463]: can't find crate for std`` 没为该目标装标准库 rustup target add <triple>
链接 C 库时报 cannot find -lssl 交叉 C 工具链没装 装对应 sysroot,或改用 rustls 替代 openssl
cargo build --target 后产物不在 target/release/ 产物在 target/<triple>/release/ 部署时从该路径取
WASM 产物体积巨大 没开 wasm-opt 与 strip 配合 wasm-pack 与 wasm-opt -Oz

面试考法:常问「为什么 Rust 交叉编译比 Go 麻烦」。答到「Go 工具链自带完整的 C 编译器替代与运行时,Rust 标准库只管 Rust 部分,遇到依赖系统 C 库的 crate(openssl、libz、libsqlite3-sys)就必须配交叉 C 工具链」。追问会问「wasm32-unknown-unknown 与 wasm32-wasi 的区别」,答案是「前者面向浏览器,没有系统调用;后者面向 WASI 运行时,能访问文件与网络」。

六、分层练习

三档练习逐档升级,上一档没做完不要跳。每档都给出验收标准与预计耗时。

6.1 复现型(照着做,目标是「跑通 + 能解释」)

练习 要求 验收标准 预计耗时
装工具链 用 rustup 装 stable、rustup component add clippy rustfmt rust-analyzer rust-src rustup show 列出全部组件;VS Code rust-analyzer 正常工作 0.5 小时
第一段工程 cargo new hello-rust,跑 cargo check 与 cargo run,对比耗时 能说出 check 比 build 快多少;target/debug/ 下有产物 0.5 小时
目录级工具链 建一个目录用 rustup override set nightly,再用 rust-toolchain.toml 固化 rustup show 在不同目录显示不同通道 1 小时
加依赖并跑 tree 加 serde、tokio,用 cargo tree -i serde 反查 能画出至少 3 层依赖树 1 小时
配镜像源 写 ~/.cargo/config.toml 替换 crates.io 源,再跑一次 cargo build 拉取日志走镜像域名;断网后 cargo build --offline 仍成功 1 小时

6.2 改造型(给出现成代码,改出正确行为)

练习 要求 验收标准 预计耗时
Edition 2021 → 2024 把一个 2021 工程切到 2024,逐个修编译错误 gen 改名、extern "C" 加 safe/unsafe;cargo check 通过 2 小时
加 MSRV 并验证 在 Cargo.toml 加 rust-version = "1.75",用 1.70 工具链试编译 看到 rustc 1.70.0 is not supported 明确报错 1 小时
release 瘦身 给 [profile.release] 加 lto = "thin"、strip = true、debug = false 产物体积对比 release 默认配置明显下降 1 小时
离线构建 cargo build --offline 在断网环境跑通 全程不访问网络;依赖全部来自本地缓存 1 小时
交叉到 WASM 装 wasm32-unknown-unknown,把 hello 工程编译成 wasm target/wasm32-unknown-unknown/release/ 下有 .wasm 文件 2 小时

6.3 设计型(自己定方案,目标是「能交付、能讲清取舍」)

练习 要求 验收标准 预计耗时
团队工具链固化方案 为一个 5 人团队设计 rust-toolchain.toml + ~/.cargo/config.toml 模板 新成员 clone 后无需手动配置即可 cargo build;镜像与代理写在仓库内可覆盖 2 小时
依赖升级流程 写一份 cargo update 操作手册,覆盖小版本升级、安全补丁、major 升级 包含 cargo tree -d、cargo audit、cargo update -p <name> --precise 三个动作 2 小时
CI 工具链矩阵 设计一个 GitHub Actions 配置:stable、beta、MSRV、cross-linux 四个 job 每个 job 都能独立通过;不依赖 cargo clean 才能复现 3 小时
生产发布 profile 给出一个 CLI 工具的 release profile 推荐配置并解释每条 包含 lto、codegen-units、strip、panic = "abort" 的取舍说明 2 小时

七、排障表

现象 可能原因 排查步骤 解决办法
error: rustc 1.70.0 is not supported by the following packages 依赖的某个 crate 声明了更高的 rust-version cargo tree 看是哪个包 升级本机 rustc,或在 Cargo.toml 里锁定旧版本
cargo build 在拉依赖阶段卡住 crates.io 网络不通 curl -I https://crates.io 看是否通 配 ~/.cargo/config.toml 镜像或 [http] proxy
error: linking with link.exe failed: exit code: 1120 Windows MSVC 工具链缺失或 PATH 不对 装 Visual Studio Build Tools 后重开终端 安装 Desktop development with C++ 工作负载
VS Code 里 rust-analyzer 一直标红但 cargo check 通过 rust-analyzer 用了错误的工具链 rustup component list 看是否装了 rust-analyzer 在 VS Code 设置里把 rust-analyzer.server.path 指到 rustup which rust-analyzer
cargo build 第一次成功、第二次突然重编译整个依赖图 修改了 Cargo.toml 或 rust-toolchain.toml 看 Cargo.lock 是否变了 正常现象;不要为此 cargo clean
error: no matching package named xxx`` 包名拼写错误或被 yank cargo search xxx 看官方索引 纠正拼写;被 yank 的版本用更早的可用版
整数在 debug 下 panic、release 下静默回绕 overflow-checks 默认随 profile 翻转 cargo build 与 cargo build --release 分别跑 i32::MAX + 1 在 [profile.release] 显式写 overflow-checks = true(调试期)或代码里用 checked_add
交叉编译报 can't find crate for std`` 没为目标装标准库 rustup target list --installed rustup target add <triple>

八、出口条件

全部勾选后再进入 阶段 1 语言基础与类型系统。

  • [ ] 能用 rustup show 一眼说清当前目录用的是哪条通道、哪个 host 三元组
  • [ ] 能在一个仓库里用 rust-toolchain.toml 钉死 nightly 日期,并解释为什么不能用浮动的 nightly
  • [ ] 能说出 cargo check、cargo build、cargo clippy、cargo fmt、cargo doc 各自做什么、为什么 check 最快
  • [ ] 能在 Cargo.toml 里写出 edition、rust-version、[profile.release] 三段,并解释每条
  • [ ] 能列出 Edition 2024 相对 2021 的至少四处确定差异(RPIT 捕获、unsafe extern、&raw、gen 保留字)
  • [ ] 能在 ~/.cargo/config.toml 配好镜像源与代理,并跑通 cargo build --offline
  • [ ] 能为一个非 host 目标(如 wasm32-unknown-unknown)成功编译出产物
  • [ ] 排障表里的八个现象,随机抽三个能在 5 分钟内给出排查路径

自测题(先自己想,再看要点):

  1. rustup override set nightly 与在目录里放一个 rust-toolchain.toml,优先级谁高?
    • 要点:override 高于 rust-toolchain.toml;RUSTUP_TOOLCHAIN 环境变量又高于 override。日常团队协作应当用 rust-toolchain.toml 提交到 Git,override 只用于本地实验。
  2. cargo check 为什么比 cargo build 快一个数量级?
    • 要点:check 不做 codegen,不调用 LLVM;只跑完 HIR 借用检查就停。LLVM 优化在 release 构建里占大头。
  3. Edition 2024 下为什么 let gen = 42; 会编译失败?这是破坏兼容吗?
    • 要点:gen 被预留为未来 generator 语法的关键字;Edition 是语言级别的不向后兼容开关,旧 2021 crate 仍能编译,只是同 crate 内统一到 2024 后旧变量名要改。
  4. rust-version = "1.75" 写在 Cargo.toml 里有什么用?用户用 1.70 编译会怎样?
    • 要点:这是 MSRV 承诺;cargo 会直接报 rustc 1.70.0 is not supported,而不是让用户在编译错误里猜。
  5. Cargo.lock 为什么二进制项目要提交、库项目不提交?
    • 要点:二进制要可复现构建;库要让下游能吃到 semver 允许的最新版,锁文件会限制下游。
  6. 为什么 debug 下 i32::MAX + 1 会 panic,release 下却静默回绕?
    • 要点:overflow-checks 在 [profile.dev] 默认 true、[profile.release] 默认 false;release 追求性能,把溢出检查去掉,需要时用 checked_add/wrapping_add 显式选语义。
  7. 国内网络下 cargo build 拉依赖卡住,除了挂代理还有什么方案?
    • 要点:在 ~/.cargo/config.toml 用 [source.crates-io] replace-with = "mirror" 换 sparse index 镜像;企业内网另搭自己的 registry,并用 --offline 做 CI。