测试

rustc 有一个内置工具，用于构建和运行 crate 的测试。关于编写和运行测试的更多信息，请参见《Rust 编程语言》书中的测试章节。

测试被写成带有 #[test] 属性的自由函数。例如

#[test]
fn it_works() {
    assert_eq!(2 + 2, 4);
}

如果测试在没有错误的情况下返回，则认为“通过”。如果它们 panic，或者返回实现了 Termination trait 且值为非零的类型（如 Result），则认为“失败”。

通过将 --test 选项传递给 rustc，编译器将以特殊模式构建 crate，以构造一个可执行文件，用于运行 crate 中的测试。--test 标志将进行以下更改：

crate 将被构建为 bin crate 类型，强制其成为一个可执行文件。
将可执行文件与标准库中的测试框架 libtest 链接，libtest 负责运行测试。
合成一个 main 函数，用于处理命令行参数并运行测试。这个新的 main 函数将替换任何现有的 main 函数作为可执行文件的入口点，尽管现有的 main 函数仍然会被编译。
启用 test cfg 选项，这允许你的代码使用条件编译来检测是否正作为测试构建。
启用带有 test 和 bench 属性注解的函数的构建，这些函数将由测试框架运行。

创建可执行文件后，你可以运行它来执行测试并接收关于哪些测试通过、哪些失败的报告。如果你使用 Cargo 管理你的项目，它有一个内置的 cargo test 命令，可以自动处理所有这些。输出示例如下：

running 4 tests
test it_works ... ok
test check_valid_args ... ok
test invalid_characters ... ok
test walks_the_dog ... ok

test result: ok. 4 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s

注意：测试必须使用 unwind panic 策略构建。这是因为所有测试都在同一个进程中运行，并且旨在捕获 panic，而使用 abort 策略是无法做到的。有关通过在单独进程中生成测试来实验性支持 abort 策略的信息，请参见不稳定的 -Z panic-abort-tests 选项。

测试属性

测试通过在自由函数上使用属性来指示。以下属性用于测试，更多详细信息请参见链接的文档：

#[test] — 指示一个函数是要运行的测试。
#[bench] — 指示一个函数是要运行的基准测试。基准测试目前不稳定，仅在 nightly channel 中可用，更多详细信息请参见不稳定文档。
#[should_panic] — 指示测试函数只有在函数 panic 时才会通过。
#[ignore] — 指示测试函数会被编译，但默认不运行。要运行这些测试，请参见 --ignored 和 --include-ignored 选项。

CLI 参数

libtest 框架有几个命令行参数来控制其行为。

注意：使用 cargo test 运行时，libtest CLI 参数必须放在 -- 参数之后，以区分 Cargo 的标志和测试框架的标志。例如：cargo test -- --nocapture

过滤器

位置参数（没有 - 前缀的参数）被视为过滤器，只会运行名称匹配其中一个字符串的测试。过滤器将匹配测试函数的完整路径中找到的任何子字符串。例如，如果测试函数 it_works 位于模块 utils::paths::tests 中，则任何过滤器 works、path、utils:: 或 utils::paths::tests::it_works 都会匹配该测试。

有关控制运行哪些测试的更多选项，请参见选择选项。