当前位置：首页 > news >正文

Rust开源测试库rstest

news 2026/3/26 20:49:16

rstest 是目前 Rust 社区中最流行的增强型测试框架。它通过过程宏（Procedural Macros）极大地扩展了标准库 #[test] 的功能。

如果你习惯 Python 的 pytest，你会发现 rstest 的设计思路非常亲切。

在前面的文章中，我们也介绍了test_case测试库。

它们在实际开发中的详细对比：

1. 核心定位区别

test-case：专注于参数化测试。它的目标是让你用最少的代码行数，给同一个函数喂不同的输入数据。
rstest：深受 Python 的 pytest 启发。它不仅支持参数化，还引入了强大的 Fixture（固件）系统，旨在解决复杂测试环境的初始化问题。

2. rstest核心功能与用法

A. 参数化测试 (Parameterized Tests)

这是最常用的功能，避免为每组输入输出编写重复的测试函数。

#[case] 模式：明确指定每一组测试数据。

use rstest::rstest;#[rstest]
#[case(1, 1, 2)]
#[case(2, 3, 5)]
fn test_add(#[case] a: i32, #[case] b: i32, #[case] expected: i32) {assert_eq!(a + b, expected);
}

#[values] 矩阵模式：自动生成参数的笛卡尔积（所有排列组合）。

#[rstest]
fn test_matrix(#[values(1, 2)] x: i32, #[values(10, 20)] y: i32) {// 会运行 4 次测试：(1,10), (1,20), (2,10), (2,20)
}

B. 固件系统 (Fixtures)

用于提取复杂的初始化逻辑（如数据库连接、Mock 对象等）。

use rstest::*;#[fixture]
fn db_connection() -> String {"Connected".to_string()
}#[rstest]
fn test_with_fixture(db_connection: String) {assert_eq!(db_connection, "Connected");
}

C. 异步支持 (Async)

原生支持异步测试，不需要手动编写 block_on。

#[rstest]
async fn test_async_process() {let result = some_async_func().await;assert!(result.is_ok());
}

2. `rstest` 的优势

重用 AST 模拟：你可以定义一个 fixture 来生成一个基础的 TokenStream，然后让几十个宏测试用例共享它。
超时处理：它提供 #[timeout(10s)] 装饰器，防止某些解析逻辑陷入死循环。
错误隔离：如果参数化测试中有某一个 case 失败了，Cargo 会明确告诉你哪组参数挂了，而不会终止其他测试。

3. 如何集成rstest

在 Cargo.toml 中添加：

toml

[dev-dependencies]
rstest = "0.18.2" # 建议使用最新版本

4. 功能特性对比

特性	test-case	rstest
参数组合 (Matrix)	不支持	支持 (可以用 `#[values(a, b)]` 跑排列组合)
异步测试 (Async)	基础支持	原生深度集成 (完美配合 `tokio`/`async-std`)
固件系统 (Fixture)	无	非常强大 (类似 pytest 的依赖注入)
超时控制 (Timeout)	无	支持 (可以给测试设时限)
编译速度	较快	略慢 (过程宏逻辑更复杂)

5. 应该如何选择？

选 test-case 的场景：
- 你正在写一个纯函数（如数学计算、字符串解析）。
- 你只需要简单的“输入 A，预期输出 B”。
- 你希望测试代码尽可能精简，不引入复杂的依赖注入概念。
选 rstest 的场景：
- 集成测试：需要频繁初始化数据库、文件系统或网络连接。
- 矩阵测试：你需要测试多种配置的排列组合（例如：3 种加密算法 × 2 种密钥长度 = 6 个测试用例）。