Rust / 系统课时

配置构建模式

配置构建模式

本课解决 Rust 项目在开发速度与运行性能之间如何取舍的问题。你将配置 Cargo 的 dev、release Profile,并通过程序输出验证优化级别、调试信息和链接时优化是否按预期生效。

学习目标

  • 理解 dev 与 release 构建模式的用途差异
  • 在 Cargo.toml 中调整优化级别、调试信息和 LTO
  • 使用 Cargo 命令验证不同 Profile 的实际行为

两种构建模式的差异

cargo build 和 cargo run 默认使用 dev Profile,优先缩短编译时间,并保留较完整的调试信息,适合日常开发。cargo build --release 与 cargo run --release 使用 release Profile,优先提升运行性能,产物放在 target/release。

Profile 只控制构建策略,不会自动改变业务逻辑。开发构建通常启用 debug_assertions,发布构建通常关闭它,因此可以用 cfg!(debug_assertions) 验证当前模式,但不应依赖它实现核心业务分支。

配置 Cargo Profile

下面创建一个最小项目,并分别配置两种构建模式。opt-level 越高,编译器优化越积极;debug 控制调试信息;lto 允许链接阶段跨代码生成单元继续优化。

toml
[package]
name = "profile-demo"
version = "0.1.0"
edition = "2024"

[profile.dev]
opt-level = 1
debug = 2

[profile.release]
opt-level = 3
debug = 1
lto = "thin"
codegen-units = 1

这里的 dev Profile 保留完整调试信息,并使用轻量优化;release Profile 使用三级优化、有限调试信息和 Thin LTO。codegen-units = 1 可能进一步改善优化效果,但会增加编译时间。

在 src/main.rs 中写入可运行程序:

rust
fn main() {
    // 该常量可用于确认当前是否启用了调试断言。
    println!("debug_assertions={}", cfg!(debug_assertions));
}

运行并验证

在项目根目录分别执行开发模式和发布模式:

bash
cargo run -q
cargo run -q --release

预期输出:

text
debug_assertions=true
debug_assertions=false

开发产物位于 target/debug,发布产物位于 target/release。若只想检查能否编译而不生成最终可执行文件,可分别运行 cargo check 和 cargo check --release。

参数选择与常见误区

调试信息不等于关闭优化。线上程序可以设置 debug = 1 或 debug = "line-tables-only",在保留基本堆栈定位能力的同时减少体积。具体支持值与效果应以当前 Rust 和 Cargo 版本为准。

LTO 会增加链接时间,不适合每次本地构建都开启。通常只在 release Profile 中使用 "thin";只有经过基准测试确认收益明显时,才考虑更重的 "fat"。

不要仅凭 release 构建成功就认定性能已经改善。优化级别、LTO 和代码生成单元都会影响编译时间、二进制体积与运行速度,应使用真实负载和基准测试做最终判断。

本课总结

  • dev Profile 偏向快速编译与调试,release Profile 偏向运行性能
  • opt-level、debug、lto 和 codegen-units 可以在 Cargo.toml 中独立调整
  • 配置是否合理应通过构建验证、产物检查和基准测试共同判断

下一课预告

下一课将进入借用检查错误排查,学习如何从编译器诊断中定位移动后使用、多重可变借用和生命周期冲突。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置构建模式

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通