测试

rustc 内置了构建和运行 crate 测试的功能。有关编写和运行测试的更多信息，请参阅 Rust 编程语言书籍的测试章节。

测试以带有 #[test] 属性的自由函数的形式编写。例如

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

如果测试返回时没有错误，则它们“通过”。如果它们 panic，或者返回一个诸如 Result 之类的实现了 Termination trait 并带有非零值的类型，则它们“失败”。

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

该 crate 将被构建为 bin crate 类型，强制它成为一个可执行文件。
将可执行文件与 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 通道中可用，有关更多详细信息，请参阅不稳定的文档。
#[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 都将匹配该测试。

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