c++ Google Mock怎么用 c++单元测试打桩入门【工具】

Google Mock 是专为 Google Test 设计的 C++ 模拟框架,用于对虚函数接口打桩以隔离被测代码;不支持非虚函数、全局函数或静态函数;需定义含虚函数的接口、用 MOCK_METHOD 宏编写 Mock 类,并通过 EXPECT_CALL 设置预期行为。

Google Mock 是 Google 提供的 C++ 模拟框架,专为配合 Google Test 使用而设计,核心用途是对依赖的接口(尤其是虚函数)打桩(mock),隔离被测代码,控制外部行为,验证调用逻辑。它不适用于非虚函数、全局函数或静态函数——这些需要其他方式(如链接期替换、模板注入或 gtest 的 TEST_F + 友元+重定义)间接处理。

一、基础准备:安装与链接

确保已集成 Google Test(gtest)。Google Mock 通常随 gtest 一起发布(路径如 googletest/googlemock)。CMake 中推荐用 find_package(GTest REQUIRED) 并链接 GTest::gmockGTest::gmock_main(后者含 main 函数,适合快速启动)。

头文件只需包含:

#include 
#include 

二、定义可 mock 的接口(必须有虚函数)

Mock 类必须继承自抽象基类,且所有待模拟的方法需声明为 virtual(纯虚更佳)。例如:

class DatabaseInterface {
public:
    virtual ~DatabaseInterface() = default;
    virtual bool Connect() = 0;
    virtual int Query(const std::string& sql) = 0;
};

这是前提——没有 virtual,Google Mock 无法覆写行为。

三、编写 Mock 类(使用 MOCK_METHOD 宏)

继承接口,用 MOCK_METHOD 声明每个要模拟的方法。语法统一为:
MOCK_METHOD(返回类型, 方法名, (参数列表), (修饰符));

常见修饰符:override(必需)、const(若原函数是 const)、Noexcept 等。例如:

class MockDatabase : public DatabaseInterface {
public:
    MOCK_METHOD(bool, Connect, (), (override));
    MOCK_METHOD(int, Query, (const std::string& sql), (override));
};

四、在测试中使用:设置预期 + 执行 + 验证

典型三步:

  • 构造 Mock 对象:通常作为测试 fixture 成员或局部变量
  • 设置期望行为(ON_CALL / EXPECT_CALL)
    • ON_CALL(mock_obj, method(...)).WillByDefault(Return(value)); —— 设定默认返回值(不校验是否调用)
    • EXPECT_CALL(mock_obj, method(...)).Times(1).WillOnce(Return(42)); —— 断言该调用**必须发生且仅一次**,并指定返回值
  • 运行被测代码(传入 mock 对象指针/引用)
  • 自动验证:测试结束时,未满足的 EXPECT_CALL 会触发失败(无需手动调用 verify)

示例片段:

TEST(DatabaseServiceTest, ShouldReturnSuccessWhenConnected) {
    MockDatabase mock_db;
    DatabaseService service(&mock_db);

    // 设置期望:Connect 被调用 1 次,返回 true;Query 被调用 1 次,返回 100
    EXPECT_CALL(mock_db, Connect()).Times(1).WillOnce(Return(true));
    EXPECT_CALL(mock_db, Query("SELECT COUNT(*)")).Times(1).WillOnce(Return(100));

    auto result = service.RunCountQuery(); // 内部调用 mock_db.Connect() 和 mock_db.Query(...)
    EXPECT_EQ(result, 100);
} // EXPECT_CALL 自动检查是否满足

五、常用技巧与避坑提示

  • _.Times(AtLeast(1))_.Times(Between(2, 5)) 表达灵活调用次数
  • 匹配参数可用 Eq(val)Ne(val)ContainsRegex("...")_(任意值)等
  • 避免在 EXPECT_CALL 后再写 ON_CALL——后者可能被前者覆盖;默认行为建议统一放在测试开头
  • 若 mock 对象析构时还有未满足的 EXPECT_CALL,会报错;确保所有预期都被触发,或用 .WillRepeatedly(...) 显式允许多次
  • 不要 mock 构造函数、析构函数、运算符重载(除非必要且明确支持)