4 测试 on 编程那些事儿

4.1 单元测试

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/testing/unit-tests.html

4.1 单元测试

Rust 与 Cargo 自带简单的单元测试框架。测试用 #[test] 标记。单元测试常放在嵌套的 tests 模块中，并用 #[cfg(test)] 仅在构建测试时条件编译。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28


// Copyright 2022 Google LLC
// SPDX-License-Identifier: Apache-2.0
fn first_word(text: &str) -> &str {
 match text.find(' ') {
 Some(idx) => &text[..idx],
 None => &text,
 }
}

#[cfg(test)]
mod tests {
 use super::*;

 #[test]
 fn test_empty() {
 assert_eq!(first_word(""), "");
 }

 #[test]
 fn test_single_word() {
 assert_eq!(first_word("Hello"), "Hello");
 }

 #[test]
 fn test_multiple_words() {
 assert_eq!(first_word("Hello World"), "Hello");
 }
}

这样可以对私有辅助函数做单元测试。
#[cfg(test)] 属性仅在运行 cargo test 时生效。

4.2 其他类型的测试

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/testing/other.html

4.2 其他类型的测试

集成测试

若要以客户端身份测试你的库，请使用集成测试。

在 tests/ 下创建 .rs 文件：

1
2
3
4
5
6
7
8
9


// Copyright 2023 Google LLC
// SPDX-License-Identifier: Apache-2.0
// tests/my_library.rs
use my_library::init;

#[test]
fn test_init() {
 assert!(init().is_ok());
}

这些测试只能访问你的 crate 的公共 API。

4.3 编译器 Lint 与 Clippy

Tue, 11 Aug 2026 11:30:00 +0800

译文 · 基于 Comprehensive Rust

原文链接: https://google.github.io/comprehensive-rust/testing/lints.html

4.3 编译器 Lint 与 Clippy

Rust 编译器能给出出色的错误信息，以及有用的内置 lint。Clippy 提供更多 lint，并按组组织，可按项目启用。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


// Copyright 2023 Google LLC
// SPDX-License-Identifier: Apache-2.0
#[deny(clippy::cast_possible_truncation)]
fn main() {
 let mut x = 3;
 while (x < 70000) {
 x *= 2;
 }
 println!("X probably fits in a u16, right? {}", x as u16);
}

这里可以看到编译器 lint，但看不到 Clippy lint。在 playground 上运行 clippy 以展示 Clippy 警告。Clippy 对其 lint 有详尽文档，并且不断新增 lint（包括默认 deny 的 lint）。