11.7 阶段 6 Cargo 工程化与质量体系
所属:全栈开发面试题库 / 学习路径 / 11 Rust 全栈
本页目录
一、阶段定位
阶段 5 解决了「怎么写出并发与异步代码」,但单人 demo 到团队服务之间隔着一整套工程化问题:多个 crate 怎么共享版本、怎么开 feature 不开全量、测试金字塔怎么搭、依赖里有 CVE 怎么发现、交叉编译怎么不把本机 glibc 带过去、Docker 镜像怎么分层缓存、CI 矩阵怎么跑。Cargo 是 Rust 官方唯一的包管理器与构建系统,但「会 cargo build」和「会搭一套能上线的 Rust 工程」之间差的就是本阶段。
与前后阶段的衔接:往上承接阶段 5——并发代码没有测试与 clippy 兜底,重构一次就崩;往下接阶段 7 的 axum 全链路——Web 服务的连接池、中间件、错误处理都要靠 feature 开关区分 dev/prod,靠 SQLx 的离线模式在 CI 上编译期校验,靠 testcontainers 起真实数据库跑集成测试。跳过本阶段直接写 Web 服务,会遇到三个典型事故:依赖版本在多个 crate 里漂移、default-features 偷偷把 openssl 拉进来、CI 因为缺数据库连接而红。
「怎么判断自己卡住了」:改一行代码等 5 分钟还没编译完;新增一个可选依赖要手动改 N 个 crate 的 Cargo.toml;本地测试过但 CI 报 SQLx 编译期失败;镜像每次都全量重建。这些都是本阶段要解决的。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
能搭一个 Workspace,用 [workspace.dependencies] 统一成员依赖版本 |
新增一个成员 crate,无需手填版本号 |
能用 feature 开关与可选依赖区分 dev/prod,解释 default-features 陷阱 |
cargo build --no-default-features 与 --all-features 行为可预期 |
能写出单元测试、集成测试、doctest 三层,并知道 #[ignore] 怎么用 |
cargo test 输出三类测试都跑过 |
| 能用 mockall 与 wiremock 写单测,能用 testcontainers 起真实依赖 | 单测不连真实下游;集成测试用容器化数据库 |
能用 criterion 做基准对比,能用 --save-baseline 看回归 |
改代码前后跑 criterion 给出对比 |
能在 CI 里跑 clippy -D warnings、cargo-deny、交叉编译与 cargo-chef 分层镜像 |
CI 绿;镜像构建缓存命中率高 |
建议学时:
- 全职(每天 4–6 小时):1.5 周,约 45–55 小时。
- 在职(每天 2 小时):4–5 周。
学时分配:Workspace 与 feature 20%、测试金字塔 25%、mock/基准/覆盖率 15%、clippy 与供应链检查 15%、交叉编译与镜像/CI 25%。
三、先修自检
| 先修项 | 合格标准 | 不合格时回到 |
|---|---|---|
| Cargo 基本命令 | cargo new/build/run/add/test 能用 |
阶段 0 工具链与开发环境 |
| TOML 语法 | 看懂 [dependencies]、features、cfg |
阶段 1 语言基础与类型系统 |
| 模块可见性 | pub mod、pub(crate)、#[cfg(test)] |
阶段 3 trait 与抽象设计 |
| Git 与 CI 基本概念 | 知道 GitHub Actions / GitLab CI 是怎么回事 | 08.4 CI/CD 与可观测性 |
| Docker 基本概念 | 知道镜像分层、Dockerfile、多阶段构建 | 08.1 容器化 |
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| Workspace | 成员 crate、workspace.dependencies、版本统一 |
会用 | 04.4.12 可观测性与测试工程化 |
| feature 开关 | optional = true、dep:、default-features |
能讲清原理 | 04.4.12 可观测性与测试工程化 |
| 测试金字塔 | #[cfg(test)]、tests/、doctest、#[ignore] |
会用 | 04.4.12 可观测性与测试工程化 |
| mock 与容器 | mockall、wiremock、testcontainers | 会用 | 04.4.12 可观测性与测试工程化 |
| 基准与覆盖率 | criterion、--save-baseline、cargo-llvm-cov |
会用 | 04.4.12 可观测性与测试工程化 |
| 静态与供应链 | clippy -D warnings、cargo-audit、cargo-deny |
会用 | 04.4.12 可观测性与测试工程化 |
| 交叉编译与镜像 | --target、cargo-chef、sccache、CI 矩阵 |
会用 | 04.4.13 部署云原生与工程架构 |
进度管理建议:Workspace 与 feature 两档务必到「能讲清原理」,其余至少「会用」。《官方文档与权威资料索引》列了各工具的权威链接。
五、分模块精讲
5.1 Workspace 与 [workspace.dependencies]
为什么需要它:一个服务拆成 N 个 crate(api、domain、infra、cli),如果每个 crate 自己写 tokio = "1.0",版本会漂移、特性集会分裂。Workspace 让成员共享一套依赖版本。
核心机制:
- 根目录
Cargo.toml写[workspace]与members = ["crates/*"]。 [workspace.dependencies]集中声明版本与 features;成员 crate 用tokio.workspace = true引用。- 成员 crate 还可以用
default-features = false覆盖根目录的 features。 [workspace.package]集中version、edition、authors,成员用version.workspace = true。- Workspace 共用一个
Cargo.lock与一个target/目录,编译缓存天然共享。
最小可运行示例:
# 根 Cargo.toml
[workspace]
resolver = "2"
members = ["crates/api", "crates/domain", "crates/cli"]
[workspace.package]
edition = "2021"
version = "0.1.0"
[workspace.dependencies]
tokio = { version = "1", features = ["full"] }
serde = { version = "1", features = ["derive"] }
thiserror = "1"
# crates/api/Cargo.toml
[package]
name = "api"
edition.workspace = true
version.workspace = true
[dependencies]
tokio = { workspace = true }
serde = { workspace = true }
domain = { path = "../domain" }
# 在根目录执行
cargo build -p api # 只构建 api
cargo test --workspace # 跑所有成员测试
cargo tree # 看依赖树
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
failed to load manifest |
根 [workspace] 与成员 [package] 冲突 |
根目录不能有 [package](除非本身也是成员) |
成员用了 tokio.workspace = true 但版本飘了 |
根目录没声明 workspace.dependencies | 在根目录补声明 |
Cargo.lock 不一致 |
部分成员独立 cargo build 过 |
在根目录统一 cargo build --workspace |
面试考法:「Workspace 解决什么问题」「为什么用 workspace.dependencies」。答到:版本统一、共享 target 缓存、避免成员间依赖版本漂移。
5.2 feature 开关与可选依赖
为什么需要它:同一个 crate 在 dev/test/prod 要用不同依赖(dev 用 wiremock、prod 用真实客户端),或者让用户按需开启数据库后端(postgres/mysql)。feature 是 Cargo 的条件编译开关。
核心机制:
[features]声明 feature:default = []、postgres = ["dep:sqlx-postgres"]。- 可选依赖:
sqlx-postgres = { version = "0.8", optional = true },只有 feature 开启才会被编译。 dep:语法显式声明「这个依赖只在 feature 里被引用」,避免optional = true自动产生同名 feature。default = ["postgres"]:默认开启的 feature。陷阱:库默认开的 feature 会被所有下游自动带上,所以库一般default = [],由二进制决定。cargo build --no-default-features/--features postgres/--all-features。- 代码里用
#[cfg(feature = "postgres")]条件编译。
最小可运行示例:
[package]
name = "store"
edition = "2021"
[dependencies]
sqlx-postgres = { version = "0.8", optional = true }
sqlx-mysql = { version = "0.8", optional = true }
serde = { version = "1", features = ["derive"] }
[features]
default = [] # 库:默认不开任何后端
postgres = ["dep:sqlx-postgres"]
mysql = ["dep:sqlx-mysql"]
// src/lib.rs
#[cfg(feature = "postgres")]
pub mod postgres_impl {
pub fn connect() -> String { "postgres".into() }
}
#[cfg(feature = "mysql")]
pub mod mysql_impl {
pub fn connect() -> String { "mysql".into() }
}
cargo build --features postgres
cargo build --no-default-features
cargo build --all-features
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
default-features = false 后还是拉了 openssl |
间接依赖的库默认开了它 | cargo tree -e features -i openssl 查谁拉的 |
库的 default = ["postgres"] 让下游被迫编译 postgres |
库默认开了重 feature | 库改 default = [],由二进制选 |
optional = true 自动产生同名 feature,导致 dep: 报错 |
旧式写法 | 用 dep:sqlx-postgres 显式声明 |
CI 跑 --all-features 失败 |
某 feature 组合互相冲突 | 用 cargo hack check 或矩阵分开跑 |
面试考法:「default-features 陷阱是什么」「dep: 语法解决什么问题」。答到:库默认开 feature 会强加给下游;optional = true 会自动产生同名 feature,dep: 把它变成纯可选依赖不暴露给用户。
5.3 测试金字塔:单元、集成、doctest 与 #[ignore]
为什么需要它:Rust 的测试分层天然清晰,但「哪些测试放 tests/、哪些放 src/、哪些写成文档示例」是新人最容易乱的。
核心机制:
- 单元测试:写在
src/*.rs里的#[cfg(test)] mod tests,可以测私有函数,与源码同 crate,编译进二进制。 - 集成测试:写在 crate 根目录的
tests/目录,每个.rs是独立 crate,只能测公开 API;适合测跨模块的真实流程。 - 文档测试(doctest):Markdown 里 ```rust 代码块,
cargo test会编译并运行;文档示例即测试,是 Rust 文档质量高的核心原因。 #[test]、#[should_panic]、#[ignore](默认跳过,cargo test -- --ignored才跑)。cargo test --release、cargo test -- --nocapture、cargo test 模块名过滤。build-dependencies与dev-dependencies:dev-dependencies只在 test/bench 时用,不进生产二进制;build-dependencies给build.rs用。
最小可运行示例:
// src/lib.rs
/// 把输入加一
///
/// ```
/// let n = workspace_demo::add_one(41);
/// assert_eq!(n, 42);
/// ```
pub fn add_one(x: i32) -> i32 { x + 1 }
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn it_works() { assert_eq!(add_one(1), 2); }
}
// tests/integration.rs
use workspace_demo::add_one;
#[test]
fn public_api() { assert_eq!(add_one(0), 1); }
[dev-dependencies]
tokio = { version = "1", features = ["test-util", "macros", "rt-multi-thread"] }
cargo test # 单元 + 集成 + doctest
cargo test --doc # 只跑 doctest
cargo test -- --ignored # 跑 #[ignore]
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| doctest 失败但文档看起来对 | 示例代码没引 crate 名 | 加 use mycrate::... 或 # fn main() { ... } 隐藏样板 |
tests/ 里测不到私有函数 |
集成测试只能测公开 API | 私有逻辑放单元测试,公开流程放集成测试 |
#[ignore] 的测试永远不跑 |
忘了 --ignored |
在 CI 里分阶段跑 |
dev-dependencies 进了生产二进制 |
写错了位置 | 移到 [dev-dependencies] |
面试考法:「Rust 三层测试怎么分」「doctest 有什么价值」。答到:单元测私有、集成测公开、doctest 即文档;示例代码不会烂文档,因为它会跑。
5.4 mock、wiremock、testcontainers 与 criterion 基准
为什么需要它:单测不能连真实下游(慢、不稳定),也不能依赖真实数据库(环境不一致)。但纯 mock 又会失真——所以分层:mock 出外部 trait、wiremock 出 HTTP 下游、testcontainers 起真实数据库。
核心机制:
- mockall:为 trait 自动生成 mock 实现,用于单测里把外部依赖换成假对象。要 mock 的 trait 加
#[cfg_attr(test, mockall::automock)]。 - wiremock:在本地起一个真实 HTTP server,用
Mock::new(...).respond(...)桩返回;比裸 mock 更接近真实 HTTP 协议。 - testcontainers:用 Docker 在测试里起 PostgreSQL/Redis/MySQL 容器,测试结束自动销毁;集成测试连真实数据库,避免「在我机器上能跑」。
- criterion:基准测试框架,
criterion_group!与criterion_main!,自动统计、噪声过滤、回归检测。criterion bench跑基准;cargo bench -- --save-baseline before保存基线;改代码后cargo bench -- --baseline before对比回归。
- 基准文件放
benches/*.rs,与tests/平级。
最小可运行示例:
// benches/bench_add.rs
use criterion::{black_box, criterion_group, criterion_main, Criterion};
fn fib(n: u64) -> u64 {
match n { 0 => 0, 1 => 1, _ => fib(n-1) + fib(n-2) }
}
fn criterion_benchmark(c: &mut Criterion) {
c.bench_function("fib 20", |b| b.iter(|| fib(black_box(20))));
}
criterion_group!(benches, criterion_benchmark);
criterion_main!(benches);
[dev-dependencies]
criterion = { version = "0.5", features = ["html_reports"] }
mockall = "0.13"
wiremock = "0.6"
testcontainers = "0.23"
cargo bench
cargo bench -- --save-baseline before-opt
# 改完优化后
cargo bench -- --baseline before-opt
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 基准结果噪声大 | 机器在跑别的任务 | 关无关程序;用 --sample-size 调大;release 跑 |
| testcontainers 启动慢 | 每次拉镜像 | 预热镜像;CI 里缓存 docker |
| mockall 编译慢 | 对大 trait 生成大量代码 | 只 mock 用到的方法 |
| 基准结果被编译器优化掉 | 函数返回值没被用 | 用 black_box(..) 包住 |
面试考法:「mock、wiremock、testcontainers 怎么选」「criterion 怎么发现回归」。答到:纯单测用 mockall,HTTP 下游用 wiremock,真实数据库用 testcontainers;--save-baseline 保存历史、--baseline 对比。
5.5 覆盖率、clippy 与供应链检查
为什么需要它:测试写了多少是一回事,覆盖了多少行是另一回事。clippy 是 Rust 官方 lint 集合,不开 -D warnings 等于裸奔。依赖里有 CVE 或未维护的 crate,要靠 cargo-audit/cargo-deny 拦住。
核心机制:
- 覆盖率:
cargo-llvm-cov(推荐,基于 LLVM):cargo install cargo-llvm-cov,跑cargo llvm-cov --html。cargo-tarpaulin(基于 tarpaulin,主要在 Linux):cargo tarpaulin --out Html。
- clippy:
cargo clippy --all-targets --all-features -- -D warnings。-D warnings把所有 warning 升为 error,CI 必须跑。- lint 分组:
clippy::correctness(默认 deny)、clippy::perf、clippy::style、clippy::complexity、clippy::pedantic(默认 allow,可选择性开)。
- 供应链检查:
cargo audit:扫Cargo.lock里已知 CVE。cargo deny:更全——advisories(CVE)、licenses(许可证合规)、bans(禁止某些 crate)、sources(只允许官方源)。- 配置文件
deny.toml放根目录。
最小可运行示例:
# 安装
cargo install cargo-llvm-cov cargo-audit cargo-deny
# 覆盖率
cargo llvm-cov --html --open
# clippy 严格模式
cargo clippy --all-targets --all-features -- -D warnings
# 供应链
cargo audit
cargo deny check
# deny.toml 最小配置
[advisories]
version = 2
ignore = []
[licenses]
allow = ["MIT", "Apache-2.0", "BSD-3-Clause", "ISC"]
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
clippy 报 needless_return 但代码能跑 |
风格 lint | 改或 #[allow(clippy::needless_return)] |
cargo audit 报 CVE 但升级不了 |
上游间接依赖 | 看 cargo tree -i <crate>,找可升级路径;暂时 ignore 并记录 |
| 覆盖率不到 60% 但测试很多 | 分支覆盖没算 | cargo llvm-cov --fail-under-lines 80 设阈值 |
cargo deny 卡在许可证 |
引入了 GPL 依赖 | 换库或法务确认 |
面试考法:「CI 里 Rust 项目要跑哪些检查」「clippy 的 -D warnings 为什么重要」。答到:cargo test、cargo clippy -D warnings、cargo fmt --check、cargo audit、cargo deny check、覆盖率报告;warning 留着迟早变事故。
5.6 交叉编译、cargo-chef 与 sccache
为什么需要它:在 macOS 上编译 Linux 二进制、在本地 musl 静态链接、Docker 镜像每次都全量重建、增量编译慢——这些都是 Rust 工程化的典型痛点。
核心机制:
- 交叉编译:
rustup target add x86_64-unknown-linux-musl。cargo build --target x86_64-unknown-linux-musl。- musl 静态链接不依赖 glibc,适合 alpine 镜像;gnu 动态链接要带 libc。
- C 依赖(
openssl、zlib)要装对应的交叉工具链,或用openssl-vendoredfeature。
- cargo-chef:把 Docker 构建分成「recipe 层」与「项目层」:先把
Cargo.toml/Cargo.lock复制进去,cargo-chef prepare生成 recipe,cargo-chef cook编译依赖;只要依赖不变,这一层就有缓存。再复制源码cargo build,源码改动只重编业务层。 - sccache:分布式/本地缓存编译结果,跨容器、跨 CI 作业复用;Rust 支持通过
RUSTC_WRAPPER=sccache启用。 - CI 矩阵:os × 工具链(stable/nightly)× feature 组合;用
cargo hack跑 feature 矩阵。
最小可运行示例:
# Dockerfile 多阶段 + cargo-chef
FROM rust:1.79 AS chef
RUN cargo install cargo-chef
WORKDIR /app
FROM chef AS planner
COPY . .
RUN cargo chef prepare --recipe-path recipe.json
FROM chef AS builder
COPY --from=planner /app/recipe.json recipe.json
RUN cargo chef cook --release --recipe-path recipe.json
COPY . .
RUN cargo build --release --bin api
FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y ca-certificates && rm -rf /var/lib/apt/lists/*
COPY --from=builder /app/target/release/api /usr/local/bin/api
ENTRYPOINT ["/usr/local/bin/api"]
# 交叉编译
rustup target add x86_64-unknown-linux-musl
cargo build --release --target x86_64-unknown-linux-musl
# sccache
cargo install sccache
export RUSTC_WRAPPER=sccache
cargo build
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
交叉编译报 linker cc not found |
缺交叉链接器 | apt install gcc-x86-64-linux-gnu 或用 musl toolchain |
openssl-sys 编译失败 |
缺 libssl-dev 或没开 vendored | features = ["openssl-vendored"] |
| Docker 缓存不命中 | COPY 顺序错(先 COPY 源码) | 先 COPY Cargo.toml/lock 跑 cook,再 COPY 源码 |
| sccache 没命中 | 源码路径变了 | 用固定路径挂载;CI 里缓存 sccache 目录 |
面试考法:「cargo-chef 为什么能加速 Docker 构建」「musl 与 gnu 的区别」。答到:依赖层先缓存,源码改动只重编业务;musl 静态链接适合 alpine,gnu 动态链接要带 libc。
5.7 build.rs 与 build-dependencies
为什么需要它:有时候需要在编译期生成代码、探测系统库、设置链接参数——这些不能放在 main.rs,要放在 build.rs。
核心机制:
- 根目录
build.rs在编译 crate 之前执行,用build-dependencies声明它自己的依赖。 - 常用输出:
println!("cargo:rustc-link-lib=ssl"):链接系统库。println!("cargo:rustc-link-search=..."):库搜索路径。println!("cargo:rerun-if-changed=..."):声明什么时候重跑 build.rs。println!("cargo:rustc-env=VAR=value"):注入编译期环境变量。
cccrate 帮你编译 C/C++ 源码;bindgen从 C 头文件生成 Rust 绑定。- 必须写
rerun-if-changed,否则每次编译都跑 build.rs,慢且行为不可预测。
最小可运行示例:
// build.rs
fn main() {
println!("cargo:rustc-link-lib=sqlite3");
println!("cargo:rerun-if-changed=build.rs");
println!("cargo:rustc-env=BUILD_TIME={}", chrono::Utc::now().to_rfc3339());
}
[build-dependencies]
chrono = "0.4"
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
每次 cargo build 都重跑 build.rs |
没写 rerun-if-changed |
补上 cargo:rerun-if-changed=... |
| 链接系统库找不到 | link-search 路径错 |
显式声明 cargo:rustc-link-search=/usr/lib |
build.rs 依赖了普通 [dependencies] |
写错位置 | 移到 [build-dependencies] |
面试考法:「build.rs 什么时候跑」「为什么要写 rerun-if-changed」。答到:编译 crate 之前跑;不写会每次都重跑且无法增量。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 搭 Workspace | 根目录 [workspace] + 3 个成员 crate |
根目录 cargo build --workspace 通过 |
1.5 小时 |
| feature 开关 | 给 crate 加 postgres/mysql 两个 feature |
--no-default-features 与 --features postgres 编译行为可预期 |
1.5 小时 |
| 三层测试 | 写一个 lib,含单元、集成、doctest | cargo test 三类都跑过 |
1 小时 |
| clippy 严格模式 | 给现有工程跑 -D warnings |
修完所有 warning,CI 命令通过 | 1 小时 |
| Docker + cargo-chef | 把现有服务按 cargo-chef 分层写 Dockerfile | 第二次构建只重编业务层 | 2 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 消除版本漂移 | 给定多 crate 各自写版本的工程 | 改成 workspace.dependencies 统一 |
2 小时 |
| 修 default-features 陷阱 | 给定库 default = ["postgres"] 让下游被迫编译 |
改为 default = [],下游按需开 |
1 小时 |
| 引入 mockall | 给定一个直接依赖真实 HTTP 客户端的函数 | 抽 trait + mock,单测不联网 | 2 小时 |
| testcontainers 集成测试 | 给定连真实 PostgreSQL 的集成测试 | 改成 testcontainers 起临时容器 | 3 小时 |
| 加覆盖率门禁 | 给 CI 加 cargo llvm-cov --fail-under-lines 80 |
覆盖率不足时 CI 红 | 1.5 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 完整 CI 流水线 | 用 GitHub Actions 跑 fmt/clippy/test/audit/deny/coverage | 任何一步失败都阻断合并 | 5 小时 |
| 交叉编译发布 | 本地 macOS 编译 Linux musl 二进制 | 在 alpine 容器里跑通 | 3 小时 |
| criterion 基准套件 | 给一个核心函数写基准,保存基线 | 改实现后能对比回归 | 3 小时 |
| 多 feature 矩阵 | 用 cargo hack 跑 feature 组合矩阵 |
所有组合都编译通过 | 3 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
failed to load manifest |
根目录同时有 [package] 与 [workspace] |
看根 Cargo.toml |
根目录只留 [workspace],业务 crate 放 crates/ |
| 编译时间 5 分钟+ | 依赖未缓存、没用 sccache | cargo build 看耗时分布 |
启 sccache;用 cargo-chef |
default-features 关不掉 |
间接依赖默认开了重 feature | cargo tree -e features -i openssl |
强制覆盖或换库 |
cargo audit 报 CVE |
依赖有已知漏洞 | cargo tree -i <crate> |
升级;不可升级时 ignore 加注释 |
| doctest 失败 | 示例代码缺 use |
cargo test --doc 看报错 |
加 use 或用 # 隐藏样板 |
| Docker 缓存不命中 | COPY 顺序错 | 看 Dockerfile 层 | 先 COPY 清单 cook,再 COPY 源码 |
| 交叉编译报 linker 错 | 缺链接器或 C 库 | 看具体 missing file | 装 musl toolchain 或 openssl-vendored |
cargo-deny 卡许可证 |
引入了不兼容许可证 | 看 deny 报告 | 换库或法务确认 |
八、出口条件
全部勾选后再进入 阶段 7 Web 服务全链路。
- [ ] 能搭一个 Workspace,用
workspace.dependencies统一成员版本 - [ ] 能解释
default-features陷阱,并用dep:写可选依赖 - [ ] 能写出单元/集成/doctest 三层测试,知道
#[ignore]用法 - [ ] 能用 mockall 与 testcontainers 分层写测试
- [ ] 能用 criterion 做基准对比并保存基线
- [ ] 能在 CI 跑
clippy -D warnings、cargo audit、cargo deny - [ ] 能用 cargo-chef 写分层 Dockerfile,缓存命中
- [ ] 排障表里随机抽三个现象,5 分钟内给出排查路径
自测题(先自己想,再看要点):
[workspace.dependencies]解决什么问题?成员 crate 怎么引用?- 要点:统一版本;
tokio.workspace = true。
- 要点:统一版本;
- 库为什么一般
default = []?- 要点:默认 feature 会强加给所有下游,库不该替用户做重依赖选择。
optional = true与dep:的区别?- 要点:前者自动产生同名 feature;后者不暴露 feature,只在 feature 里显式引用。
- Rust 三层测试怎么分?
- 要点:
#[cfg(test)]测私有;tests/测公开 API;doctest 即文档示例。
- 要点:
- cargo-chef 为什么能加速?
- 要点:先把
Cargo.toml/lock 复制进去 cook 依赖层,源码改动只重编业务层。
- 要点:先把
- CI 里 Rust 项目最少要跑哪些检查?
- 要点:fmt、clippy
-D warnings、test、audit、deny、覆盖率。
- 要点:fmt、clippy
build.rs为什么要写rerun-if-changed?- 要点:不写会每次都重跑且无法增量;写了只在指定文件变时重跑。