测试

rustc 具有内置的功能，用于构建和运行箱子的测试。有关编写和运行测试的更多信息，请参阅 Rust 编程语言手册的测试章节。

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

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

如果测试在没有错误的情况下返回，则测试“通过”。如果测试恐慌，或者返回一个类型（例如 Result）它实现了 Termination 特性，并且具有非零值，则测试“失败”。

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

箱子将被构建为一个 bin 箱子类型，强制它成为一个可执行文件。
将可执行文件与 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 恐慌策略构建。这是因为所有测试都在同一个进程中运行，并且它们旨在捕获恐慌，而使用 abort 策略则无法做到这一点。有关通过在单独的进程中生成测试来实验性支持 abort 策略的更多信息，请参阅不稳定的 -Z panic-abort-tests 选项。

测试属性

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

#[test] — 指示一个函数是一个要运行的测试。
#[bench] — 指示一个函数是一个要运行的基准测试。基准测试目前不稳定，并且仅在 nightly 通道中可用，有关更多详细信息，请参阅不稳定文档。
#[should_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 都将匹配该测试。

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