Docker构建优化：如何清理Cargo缓存中的指定crate？

为优化Docker构建时长，我尝试通过预编译依赖来缓存构建结果，但运行Dockerfile时，最终构建阶段Cargo仍保留了之前生成的Dummy main代码。

我的Dockerfile内容 #

# 仅复制Cargo文件以利用缓存
COPY Cargo.toml Cargo.lock ./
COPY ./compA/Cargo.toml ./compA/
COPY ./compB/Cargo.toml ./compB/

RUN  mkdir -p ./compA/src && echo "fn main() { println!(\"Dummy main\"); }" > ./compA/src/lib.rs
RUN  mkdir -p ./compB/src && echo "fn main() { println!(\"Dummy main\"); }" > ./compB/src/main.rs

RUN cargo fetch

# || true 允许即使依赖不可用也能成功（因为依赖也会在此处编译）
RUN cargo build --release || true

# 复制真实源码
COPY . .

# 专门清理两个dummy模块
cargo clean -p compA -p compB

# 现在编译真实源码
RUN cargo build --release

现象 #

• 真实代码已正确复制：

#30 [builder 24/29] RUN cat compA/src/lib.rs
#30 0.319 // expected source code
#30 DONE

• 但构建时仍出现dummy代码的缓存警告：

#35 [builder 29/29] RUN cargo build --release
#35 0.534 warning: function is never used: `main`
#35 0.482  --> compA/src/lib.rs:1:4
#35 0.482   |
#35 0.482 1 | fn main() { println!("Dummy main"); }
#35 0.482   |    ^^^^
#35 0.482   |

尝试过的方法 #

• cargo clean：有效，但会删除所有依赖的编译产物，违背缓存预编译依赖的初衷
• cargo clean -p compA：无效果
• cargo clean -p compA@0.1.0：报错，尽管这是cargo pkgid的SPEC语法

方法1：直接删除本地包的编译产物目录 #

Cargo的编译产物默认存放在target/release/deps下，直接删除对应包的产物文件即可，替代无效的cargo clean -p：

# 复制真实源码
COPY . .

# 删除compA和compB的编译产物
RUN rm -rf target/release/deps/compA* target/release/deps/compB*

# 编译真实源码
RUN cargo build --release

方法2：用--fresh参数强制重新编译指定包 #

最终构建时，强制Cargo重新编译compA和compB，跳过缓存，保留其他依赖的预编译结果：

# 复制真实源码
COPY . .

# 强制重新编译目标包
RUN cargo build --release --fresh compA compB

方法3：调整dummy文件的生成逻辑 #

避免生成和真实代码结构冲突的dummy代码，比如compA是库包，就不要写main函数，改成符合库结构的空代码：

RUN  mkdir -p ./compA/src && echo "pub mod compa {}" > ./compA/src/lib.rs
RUN  mkdir -p ./compB/src && echo "fn main() {}" > ./compB/src/main.rs

这样即使缓存残留，也不会出现无用函数警告，真实代码覆盖后能正常编译。

方法4：通过--manifest-path精准清理本地包 #

针对工作区中的本地包，用指定manifest文件路径的方式调用cargo clean，避免pkgid语法问题：

# 复制真实源码
COPY . .

# 精准清理指定包
RUN cargo clean -p compA --manifest-path ./compA/Cargo.toml
RUN cargo clean -p compB --manifest-path ./compB/Cargo.toml

# 编译真实源码
RUN cargo build --release

内容的提问来源于stack exchange，提问作者til