24、Rust 测试与文档编写全解析

Rust 测试与文档编写全解析

1. 测试失败处理

在 Rust 中，有时我们需要测试一个函数是否会触发 panic。可以通过在测试函数顶部添加 #[should_panic] 属性来实现：

#[should_panic]
#[test]
fn test_dummy() {
    assert!(false, "Always fail");
}

运行该测试时，测试会通过。

2. 忽略测试

若某些测试耗时较长，或者不想每次都运行特定测试，可以在函数上方添加 #[ignore] 属性：

#[ignore]
#[test]
fn test_dummy() {
    assert!(false, "Always fail");
}

运行测试时，该测试函数将被忽略。若要运行被忽略的测试，需给运行测试的程序传递命令行参数：

cargo test -- --ignored

3. 单元测试示例

下面是一个解码器的单元测试示例：

#[cfg(test)]
mod tests {
    // …
    #[test]
    fn test_decoder() {
        let