mockall仅作为dev-dependency时，集成测试无法识别automock生成的Mock结构体

问题原因 #

单元测试属于主 crate 内部编译单元，编译时自动启用test配置，因此#[cfg_attr(test, automock)]会生成Mock结构体；而tests目录下的集成测试是独立的编译目标，编译主 crate 时默认不会启用test配置，导致Mock结构体未生成，从而出现“unresolved import”错误。

解决方案 #

通过feature控制Mock结构体的生成，让集成测试编译主 crate 时触发Mock代码生成，同时保持mockall仅作为dev依赖：

1. 修改Cargo.toml配置 #

添加一个用于控制Mock生成的feature，并确保mockall在dev依赖中：

[features]
# 定义feature，用于触发Mock结构体生成
test-mocks = []

[dependencies]
# 你的其他主依赖...

[dev-dependencies]
mockall = "0.11" # 版本号根据你使用的调整

2. 调整主 crate 中Trait的属性 #

将原来的#[cfg_attr(test, automock)]改为同时支持test配置和test-mocksfeature，确保单元测试和集成测试都能生成Mock：

// 定义Trait的文件（比如src/lib.rs）
#[cfg_attr(any(test, feature = "test-mocks"), automock)]
pub trait MyTrait {
    fn do_something(&self) -> String;
}

3. 让集成测试启用feature #

有两种方式启用test-mocksfeature：

• 方式一：通过Cargo.toml全局配置
  在Cargo.toml中为所有集成测试目标启用feature：

  [[test]]
  name = "*" # 匹配所有tests目录下的测试文件
  features = ["test-mocks"]
  

  或者指定单个测试文件：

  [[test]]
  name = "my_integration_test"
  path = "tests/my_integration_test.rs"
  features = ["test-mocks"]
  

• 方式二：运行测试时手动指定feature
  执行测试命令时加上--features参数：

  cargo test --features test-mocks
  

4. 集成测试中正常导入Mock结构体 #

现在可以在集成测试文件中正常导入并使用Mock结构体了：

// tests/my_integration_test.rs
use my_crate::{MyTrait, MockMyTrait};

#[test]
fn test_integration_with_mock() {
    let mut mock = MockMyTrait::new();
    mock.expect_do_something().returning(|| "mocked response".to_string());
    
    assert_eq!(mock.do_something(), "mocked response");
}

额外说明 #

rust-analyzer能提供自动补全是因为它默认会分析测试配置，但实际编译时集成测试未触发Mock生成，所以通过feature明确控制即可解决这个差异问题。

内容的提问来源于stack exchange，提问作者Jérôme MEVEL