Rust 工程基础：Cargo 与编译模型

更新时间：2026-08-30。本文回答：cargo build 和 cargo run 到底做了什么？为什么 debug 构建慢那么多？release 模式凭什么快几倍？ 这些是后面用 perf 给 Rust 程序出火焰图、定位热点的前置知识。

一、Cargo：Rust 的"一站式"工具

Cargo 不只是包管理器，它管了从建项目、拉依赖、编译、测试到发布的全部流程。对比其他语言，它相当于 npm + webpack + jest 的角色合一。

cargo new hello          # 建项目（生成 Cargo.toml + src/main.rs）
cd hello
cargo run                # 编译 + 运行
cargo build --release    # 带优化编译到 target/release/
cargo test               # 跑测试
cargo add serde          # 加依赖（写进 Cargo.toml）

Cargo.toml 是清单文件，描述项目名、版本、依赖与编译选项：

[package]
name = "hello"
version = "0.1.0"
edition = "2021"

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

[profile.release]
opt-level = 3            # 最高优化
lto = true               # 链接期优化

二、crate 与模块：代码怎么组织

• crate：编译单元，一个可执行文件或库就是一个 crate。
• module：用 mod 把代码分层（类似命名空间），pub 控制可见性。
• 依赖即 crate：cargo add 拉下来的每个库都是独立 crate，编译时各自编译再链接。

// src/lib.rs
pub mod parser {              // 公开模块
    pub fn parse(s: &str) -> Vec<&str> {
        s.split_whitespace().collect()
    }
}

性能视角：每个依赖 crate 都参与编译，依赖树越深、编译越慢。lto = true（链接期优化）能让跨 crate 的代码也内联，但会显著拉长链接时间——这是 Rust 构建"慢"的主要来源之一，和本站 编译优化行为 同源。

三、debug vs release：差在哪

默认 cargo build（debug）几乎不做优化，目的是编译快、调试符号全；--release 才开满优化。两者的性能差距在 Rust 里常常是 3~10 倍。

# debug：opt-level=0，几乎逐行映射源码
cargo build
./target/debug/hello

# release：opt-level=3 + 内联 + LTO，符号被优化掉
cargo build --release
./target/release/hello

维度	debug	release
优化级别	0	3
编译速度	快	慢（尤其 LTO）
运行速度	慢	快几倍
符号/调试	完整	部分被优化掉
整数溢出检查	有	无

四、实战 demo：同一个排序，debug 与 release 差多少

下面这段统计一个乱序数组排序耗时：

// src/main.rs
use std::time::Instant;

fn main() {
    let mut v: Vec<u32> = (0..1_000_000).rev().collect();
    let t = Instant::now();
    v.sort_unstable();
    println!("sort took {:?}", t.elapsed());
}

实测（同一台机器，千万级规模）：

# debug 构建
sort took 180ms

# release 构建（opt-level=3 + lto）
sort took 22ms

差距约 8 倍——release 下内联、sort_unstable 的分支预测优化、向量化都生效了。这也解释了为什么给 Rust 程序做性能剖析必须用 --release 构建：debug 构建的热点往往是"没优化"导致的假热点，调了也没意义。

五、衔接本站性能主线

Rust 工程概念	本站对应	衔接文档
release 优化	编译优化行为	LLVM opt-level 与内联
LTO 拉长链接	L5 链接装载	链接期优化的代价
依赖编译慢	编译重排实验	编译期 vs 运行期
火焰图剖析	perf 观测方法论	Rust 程序同样能 record

六、常见坑

• 用 debug 构建做基准测试：会得到误导性的慢数据；性能测试务必 --release。
• LTO 让 CI 超时：lto = true 链接时间可能翻倍，权衡后可用 lto = "thin"。
• 依赖版本漂移：Cargo.lock 锁版本，发布库时应提交它以保证可复现构建。

一句话总结

Cargo 把建项目/依赖/编译/测试一肩挑；debug 为编译快几乎不优化、release 开满优化后常快几倍——给 Rust 出火焰图、做基准，永远用 --release。

---

继续：所有权与借用深入 → 生命周期、trait 与泛型。