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

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

一 基础与通用加速

• 保持工具链最新：定期执行 rustup update，新版本编译器在优化与增量方面持续有改进。
• 日常开发用 cargo check 替代 cargo build，只做类型与借用检查，避免生成二进制，反馈更快。
• 增量与并行：确保启用增量（stable 默认开启），并按机器核数设置并行作业数，例如 cargo build -j $(nproc)；在 ~/.cargo/config.toml 中可显式配置并行与增量：
  [build]
  jobs = 16
  incremental = true
• 使用更快的测试运行器：以 cargo-nextest 替代 cargo test，能显著缩短测试执行时间，适合大型项目与 CI。
• 分析瓶颈：用 cargo build --timings 查看各 crate 编译耗时；用 cargo rustc – -Zself-profile 生成火焰图定位慢点。

二 缓存与 CI 优化

• 本地与 CI 统一缓存：使用 sccache 复用编译产物，设置环境变量 export RUSTC_WRAPPER=$(which sccache)；CI 中缓存 $CARGO_HOME 与 target/ 目录（GitHub Actions 可用 rust-cache 官方 Action，GitLab 可用 sccache 缓存）。
• 定期清理无用缓存：安装 cargo-cache 并执行 cargo cache --autoclean，避免磁盘被陈旧产物占满。

三 链接与代码生成优化

• 更快的链接器：优先使用 lld 或 mold。示例配置（~/.cargo/config.toml）：
  [target.x86_64-unknown-linux-gnu]
  linker = “clang”
  rustflags = [“-C”, “link-arg=-fuse-ld=lld”]
  若已安装 mold，可改为 -fuse-ld=mold。
• 调试构建提速：保持 dev 配置轻量，例如 opt-level = 0、debug = 1（仅行表）、codegen-units = 16、lto = false；发布构建再用高优化。
• 可选实验特性：在 Nightly 下尝试并行前端 -Z threads=N（如 -Z threads=8），示例：
  RUSTFLAGS=“-Z threads=8” cargo +nightly build
  或在配置中：
  [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；并行作业数可按机器核数调整。