Debian系统Rust编译速度如何提升

Debian 上提升 Rust 编译速度的可落地方案

Rust 的编译速度，是不少开发者心里的痛，尤其在 Debian 这种稳定优先的系统上，如果不做任何调优，大型项目编译起来确实有点“熬人”。但好消息是，只要掌握几个关键技巧，提速效果立竿见影。下面这套方案，从日常开发到 CI 流水线，几乎覆盖了所有可落地的优化点。

一、基础与通用加速

先从最基础的开始。先把工具链养到最新版，定期执行 rustup update，新版本编译器在优化和增量编译方面，持续有改进。这一点虽然简单，但最容易被忽略。

日常开发时，多用 cargo check 替代 cargo build。它只做类型检查和借用检查，不生成二进制文件，反馈速度快得多。等逻辑确认无误了，再跑完整构建。

增量编译和并行编译是默认就有的红利，但需要确认没有误关。在 ~/.cargo/config.toml 中显式配置一下更稳妥：

[build]
jobs = 16
incremental = true

这里的 jobs 建议按机器物理核数来设置，比如 16 核机器就填 16。

测试环节，cargo-nextest 是比 cargo test 更快的选择，尤其适合大型项目和多模块项目，CI 里用效果更明显。

最后，别忘了分析瓶颈。用 cargo build --timings 可以查看每个 crate 的编译耗时，cargo rustc -- -Zself-profile 能生成火焰图，精准定位慢点。别盲目优化，先找到瓶颈在哪。

二、缓存与 CI 优化

本地和 CI 统一使用 sccache 来缓存编译产物。设置环境变量 export RUSTC_WRAPPER=$(which sccache) 即可启用。CI 环境里，GitHub Actions 用户可以用官方的 rust-cache Action，GitLab 用户则直接缓存 sccache 的目录。

缓存虽好，但也会越积越多。安装 cargo-cache 后，定期执行 cargo cache --autoclean，能避免磁盘被陈旧产物占满。这个习惯，建议从项目初期就养成。

三、链接与代码生成优化

换链接器，是提速最立竿见影的操作之一。优先推荐 lld 或 mold，配置如下：

[target.x86_64-unknown-linux-gnu]
linker = "clang"
rustflags = ["-C", "link-arg=-fuse-ld=lld"]

如果安装的是 mold，把 -fuse-ld=lld 改为 -fuse-ld=mold 即可。

调试构建时，别让优化力度拖累速度。保持 dev 配置轻盈：opt-level = 0、debug = 1（仅行表）、codegen-units = 16、lto = false。这些设置只影响开发阶段，发布构建再追求极致优化。

如果你在用 Nightly 版本，可以尝试并行前端特性 -Z threads=N。比如：

RUSTFLAGS="-Z threads=8" cargo +nightly build

或者在配置中写入 rustflags = ["-Z", "threads=8"]。注意，这个特性还是实验性的，收益因项目而异，但值得一试。

四、依赖与工程结构优化

依赖管理，是个精细活。用 cargo-machete 可以快速识别并移除未使用的依赖，减少编译和链接的开销。这一步，往往能清理掉不少“历史包袱”。

对于外部依赖，尽量设置 default-features = false，只启用真正需要的功能。这能显著降低依赖树复杂度，减少编译量。很多 crate 的默认特性里，藏着不少你根本用不上的东西。

如果项目里某个 crate 已经“巨无霸”了，不妨按功能拆分为 workspace。这样能减少单次编译规模，提高并行度，也更容易命中缓存。

五、一键可用的最小配置示例

最后，给出一份可以直接复制使用的配置。本地开发用的 ~/.cargo/config.toml：

[build]
jobs = 16
incremental = true
rustflags = ["-C", "link-arg=-fuse-ld=lld"]

[profile.dev]
opt-level = 0
debug = 1
codegen-units = 16
lto = false

[profile.release]
opt-level = 3
lto = "thin"
codegen-units = 1
panic = "abort"
strip = true

环境与工具方面，安装并启用缓存：

export RUSTC_WRAPPER=$(which sccache)

可选安装：

cargo install cargo-machete cargo-nextest

使用方式上，开发阶段用 cargo build、cargo check 或 cargo nextest run；发布时用 cargo build --release；分析瓶颈时用 cargo build --timings 或 cargo rustc -- -Zself-profile。

如果 lld 不可用，换成 mold 即可。并行作业数按机器核数调整，别盲目设大。这套配置，基本能覆盖大多数 Debian 下的 Rust 项目，上手即用。