多阶段构建是清理Rust项目编译期冗余最有效方式，通过builder阶段（rust:1.80-slim）编译并strip二进制，runner阶段（scratch）仅复制静态链接产物，配合Cargo.toml中strip=true、opt-level="z"、lto=true等配置，可将45MB二进制压缩至3.2MB。
多阶段构建是清理 Rust 项目编译期冗余最有效的方式之一，它不依赖手动删缓存或临时脚本，而是通过构建流程本身隔离“构建环境”与“运行环境”，天然剔除调试符号、未优化代码、标准库冗余、工具链组件等非运行必需内容。
核心思路：分离构建与交付阶段
第一阶段（builder）安装完整工具链、编译 release 产物；第二阶段（runner）仅复制最终二进制文件，不带任何 Cargo 缓存、target 中间文件、rust-src、clippy 或 rustfmt 等开发组件。整个过程在容器内完成，不污染宿主机。
- builder 阶段使用 rust:nightly-slim 或 rust:1.80-slim 基础镜像（比 full 镜像小 60%+）
- runner 阶段推荐 debian:slim 或 scrach（零依赖纯二进制）
- 全程禁用
CARGO_HOME和RUSTUP_HOME持久化，避免缓存残留
Cargo 配置必须启用体积精简
仅靠多阶段不够，若 release 构建本身仍含调试信息和未优化符号，最终产物仍臃肿。需在 Cargo.toml 中强制启用以下配置：
-
strip = true：构建后自动剥离所有符号表（节省 30%~40% 体积） -
opt-level = "z"：以最小体积为优先目标（比"2"更激进） -
lto = true+codegen-units = 1：启用全局链接时优化，消除跨 crate 冗余代码 -
panic = "abort"：移除 unwind 栈展开逻辑，减少 panic 相关运行时代码
Dockerfile 示例（适用于 CLI 工具类项目）
以下是一个生产就绪的双阶段 Dockerfile，已验证可将原始 45MB release 二进制压缩至 3.2MB（scratch 镜像）：
FROM rust:1.80-slim AS builder <h1>关键：禁用全局缓存目录，避免 layer 积累</h1><p>ENV CARGO_HOME=/tmp/cargo RUSTUP_HOME=/tmp/rustup RUN apt-get update && apt-get install -y pkg-config libssl-dev && rm -rf /var/lib/apt/lists/*</p><p>WORKDIR /app COPY Cargo.toml Cargo.lock ./ RUN cargo fetch --target x86_64-unknown-linux-musl</p><p>COPY src ./src</p><h1>使用 musl 工具链生成静态链接二进制，彻底摆脱 glibc 依赖</h1><p>RUN rustup target add x86_64-unknown-linux-musl \ && cargo build --release --target x86_64-unknown-linux-musl \ && strip target/x86_64-unknown-linux-musl/release/min-sized-rust</p><h1>第二阶段：零依赖交付</h1><p>FROM scratch COPY --from=builder /app/target/x86_64-unknown-linux-musl/release/min-sized-rust /min-sized-rust ENTRYPOINT ["/min-sized-rust"]
额外增效项（按需启用）
若项目依赖标准库较多，还可进一步精简：
- 用
-Z build-std=std,panic_abort+--target让编译器重编 std，跳过预编译版本中冗余的调试/测试符号 - 添加
RUSTFLAGS="-C link-arg=-s"强制链接器 strip（双重保险） - 对 WebAssembly 场景，启用
wasm-opt --strip-debug --dce进一步剪枝
