Rust / 系统课时
构建发布版本
构建发布版本
发布前不仅要执行一次 cargo build --release,还要确认产物位置、文件体积、依赖类型和目标平台。完成本课后,你将得到一个可运行的优化版本,并能用一套最小检查流程判断它是否适合交付。
学习目标
- 使用 Cargo 生成并运行 release 产物
- 区分 Rust 包依赖与系统动态库依赖
- 核对目标三元组并完成发布前验收
生成 release 产物
Cargo 的 release 配置会启用优化,产物默认进入 target/release。在已有项目中应保留并提交 Cargo.lock,再使用 --locked 防止构建过程更新依赖解析结果。
下面创建一个最小项目,先运行测试,再构建并启动发布版本:
cargo new release-demo
cd release-demo
cargo test
cargo build --release --locked
./target/release/release-demo预期输出:
Creating binary (application) `release-demo` package
running 0 tests
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out
Finished `release` profile [optimized] target(s) in <TIME>
Hello, world!<TIME> 会随机器性能和缓存状态变化。Windows 产物名为 target\release\release-demo.exe,可在 PowerShell 中直接运行该文件。
检查体积与依赖
文件大小只能说明产物占用空间,不能单独证明它可部署。还要分别检查 Cargo 依赖树和操作系统运行时依赖。以下命令以 Linux 为例:
ls -lh target/release/release-demo
cargo tree --locked
ldd target/release/release-demo预期输出:
-rwxr-xr-x ... <SIZE> ... target/release/release-demo
release-demo v0.1.0 (<PATH>)
<SHARED_LIBRARY_LIST>cargo tree 展示编译时使用的 Rust crate;ldd 展示运行程序时需要的动态库,两者不能互相替代。macOS 可用 otool -L,Windows 可用 Visual Studio 工具链中的 dumpbin /dependents。实际大小、路径和库列表会因系统与编译器版本不同而变化。
按需缩减体积
对体积敏感的命令行程序,可以在 Cargo.toml 中调整 release profile:
[profile.release]
lto = "thin"
codegen-units = 1
strip = "symbols"
panic = "abort"这组配置会启用 Thin LTO、减少代码生成单元、剥离符号,并在 panic 时直接终止进程。它通常会延长编译时间,也会改变 panic 的清理行为;修改后应重新构建,再用前面的大小和运行命令比较结果。
确认目标平台与验收
Rust 使用目标三元组描述 CPU 架构、操作系统和 ABI。先核对当前主机,再明确构建目标;“目标可被列出”不代表本机已经安装对应标准库或交叉链接器。
以下示例适用于 Linux x86_64 主机:
rustc -vV
rustup target list --installed
rustup target add x86_64-unknown-linux-gnu
cargo build --release --locked --target x86_64-unknown-linux-gnu预期输出:
rustc <VERSION> (<COMMIT> <DATE>)
host: x86_64-unknown-linux-gnu
x86_64-unknown-linux-gnu
info: component 'rust-std' for target 'x86_64-unknown-linux-gnu' is up to date
Finished `release` profile [optimized] target(s) in <TIME>指定 --target 后,产物位于 target/x86_64-unknown-linux-gnu/release/release-demo。若主机与目标平台不同,还可能需要对应的 C 工具链、链接器和系统库;构建成功后仍应在真实目标环境或等价容器中启动验证。
交付前至少确认测试通过、release 二进制可启动、目标三元组正确、动态库可用、配置文件与运行权限齐全。涉及外部资源、证书或数据库迁移时,也要纳入同一份发布清单。
本课总结
cargo build --release --locked可生成依赖解析稳定的优化产物- 体积、crate 依赖和系统动态库需要分别检查
- 目标三元组匹配只是基础,最终仍要在目标环境运行验证
下一课预告
下一课将把构建、测试和产物检查串成自动化发布流程,减少手工操作造成的遗漏。