如何将外部文件定义的测试用例集成到cargo test中

要让tests/目录里的每个文件在cargo test中显示为单独的测试项，你得跳出“运行时遍历文件”的思路——因为Cargo的测试发现是编译时扫描带#[test]标记的函数，运行时动态执行的逻辑只会被当成一个测试用例。

下面是两种可行的实现方式：

方式一：编译时宏自动生成测试函数（推荐） #

借助glob和paste两个crate，在编译阶段遍历tests/下的所有文件，为每个文件自动生成对应的#[test]函数。

1. 先在Cargo.toml里添加开发依赖：

[dev-dependencies]
glob = "0.3"
paste = "1.0"

2. 编写测试代码：

use glob::glob;
use paste::paste;

// 编译时遍历tests/目录，为每个文件生成独立测试函数
glob!("../tests/*").unwrap().into_iter().for_each(|entry| {
    let path = entry.unwrap();
    // 提取文件名作为测试函数名的一部分
    let file_name = path.file_name().unwrap().to_str().unwrap();

    paste! {
        #[test]
        fn [<test_ $file_name>]() {
            testcase(path.to_str().unwrap());
        }
    }
});

// 你的测试逻辑函数
fn testcase(file_path: &str) {
    // 这里写你的测试逻辑，比如读取文件内容验证
    let content = std::fs::read_to_string(file_path).expect("Failed to read test file");
    assert!(!content.is_empty(), "Test file {} is empty", file_path);
}

这样编译时就会为每个测试文件生成形如test_xxx的测试函数，cargo test会把它们当成独立的测试项展示，失败时也能直接定位到对应文件。

方式二：手动编写测试函数（适合少量文件） #

如果测试文件数量不多，直接为每个文件写单独的#[test]函数更简单：

#[test]
fn test_login_case() {
    testcase("tests/login_test.txt");
}

#[test]
fn test_payment_case() {
    testcase("tests/payment_test.txt");
}

fn testcase(file_path: &str) {
    // 测试逻辑
}

这种方式无需额外依赖，但文件多了之后维护起来麻烦。

核心原理 #

Cargo不会识别运行时动态执行的测试逻辑，只有编译时存在的、带#[test]标记的函数才会被当成独立测试用例。所以必须通过编译时手段为每个测试文件生成对应的测试函数，才能实现你的需求。

内容的提问来源于stack exchange，提问作者glasflügel