9、Rust 测试、文档与基准测试全解析

Rust 测试、文档与基准测试全解析

1. 测试相关

1.1 失败测试

在某些测试用例中，我们希望 API 方法根据特定输入而失败，并且让测试框架断言这种失败。Rust 为此提供了 #[should_panic] 属性。示例代码如下：

// panic_test.rs
#[test]
#[should_panic]
fn this_panics() {
    assert_eq!(1, 2);
}

#[should_panic] 属性与 #[test] 属性配合使用，表示运行 this_panics 函数会导致不可恢复的失败，即 Rust 中的 panic。

1.2 忽略测试

#[ignore] 是编写测试时另一个有用的属性。如果测试代码非常繁重， #[ignore] 注解能让测试工具在运行 cargo test 时忽略这些测试函数。可以通过向测试运行器或 cargo test 命令提供 --ignored 参数来单独运行这些测试。示例代码如下：

// silly_loop.rs
pub fn silly_loop() {
    for _ in 1..1_000_000_000 {};
}