如何在Rust单元测试与集成测试中共用Test Helper？

在Rust中，单元测试（位于src/目录下）和集成测试（位于tests/目录下）的编译环境存在差异，导致测试助手无法直接跨环境共享。下面提供几种可行的解决方案：

方案一：使用Cargo特性（Feature）控制编译（推荐中小型项目） #

通过特性标记让测试助手同时对单元测试和集成测试可见：

1. 在Cargo.toml中添加测试专用特性

[features]
test-utils = []

2. 在src/下创建测试助手模块
   创建src/test_utils.rs，用#[cfg(any(test, feature = "test-utils"))]标注所有需要共享的代码，确保单元测试（自动启用test配置）和集成测试（手动启用test-utils特性）都能访问：

#[cfg(any(test, feature = "test-utils"))]
pub struct TestHelper {}

#[cfg(any(test, feature = "test-utils"))]
impl TestHelper {
    pub fn meaning(&self) -> i32 {
        42
    }
}

然后在src/lib.rs中导出该模块：

#[cfg(any(test, feature = "test-utils"))]
pub mod test_utils;

3. 单元测试中使用助手
   直接从crate内部导入即可：

#[cfg(test)]
mod tests {
    use crate::test_utils::TestHelper;

    #[test]
    fn test_unit_function() {
        let helper = TestHelper {};
        assert_eq!(helper.meaning(), 42);
    }
}

4. 集成测试中使用助手
   在集成测试文件顶部导入，并运行测试时启用test-utils特性：

use your_crate_name::test_utils::TestHelper;

#[test]
fn test_integration_flow() {
    let helper = TestHelper {};
    assert_eq!(helper.meaning(), 42);
}

运行集成测试的命令：

cargo test --features test-utils

方案二：创建独立的测试助手Crate（推荐大型项目） #

如果项目结构复杂，可将测试助手抽成单独的Crate，让单元测试和集成测试都依赖它：

1. 添加工作区配置
   在项目根目录的Cargo.toml中添加工作区，包含主Crate和测试助手Crate：

[workspace]
members = [".", "test_utils"]

2. 创建测试助手Crate
   新建test_utils/目录，在其中创建Cargo.toml：

[package]
name = "your_crate_test_utils"
version = "0.1.0"
edition = "2021" # 与主Crate版本保持一致

在test_utils/src/lib.rs中定义测试助手：

pub struct TestHelper {}

impl TestHelper {
    pub fn meaning(&self) -> i32 {
        42
    }
}

3. 在主Crate中添加测试依赖
   在主Crate的Cargo.toml中添加开发依赖：

[dev-dependencies]
your_crate_test_utils = { path = "./test_utils" }

4. 单元测试和集成测试中使用助手
   单元测试中导入：

#[cfg(test)]
mod tests {
    use your_crate_test_utils::TestHelper;

    #[test]
    fn test_unit() {
        let helper = TestHelper {};
        assert_eq!(helper.meaning(), 42);
    }
}

集成测试中直接导入使用：

use your_crate_test_utils::TestHelper;

#[test]
fn test_integration() {
    let helper = TestHelper {};
    assert_eq!(helper.meaning(), 42);
}

运行测试无需额外参数，直接执行cargo test即可。

方案三：相对路径导入（不推荐） #

如果只是临时方案，可在单元测试中通过相对路径直接导入tests/目录下的测试助手，但这种方法依赖项目结构，路径变更时容易出错：

#[cfg(test)]
mod tests {
    #[path = "../../tests/test_helper.rs"]
    mod test_helper;
    use test_helper::TestHelper;

    #[test]
    fn test_unit() {
        let helper = TestHelper {};
        assert_eq!(helper.meaning(), 42);
    }
}

内容的提问来源于stack exchange，提问作者vextorspace