第12章:测试驱动开发(TDD):红绿循环、Mock对象(Google Mock)、测试覆盖率

说实话,我刚入行那几年,对测试的态度是「能省则省」。总觉得写测试浪费时间,有那功夫不如多写几行业务代码。直到有一次,我负责的一个支付模块,因为一个边界条件没处理好,线上出了严重事故。那天晚上我盯着屏幕,看着日志里那一串串异常,心里只有一个念头:如果当初写了单元测试,这问题早该发现了。

从那以后,我成了测试驱动开发(TDD)的忠实拥趸。今天我们就来聊聊TDD的核心实践,以及C++项目中怎么用好它。

12.1 红绿循环:TDD的节奏感

TDD的核心,说白了就是三个步骤的循环:红 → 绿 → 重构。我习惯叫它「红绿循环」,因为每次跑测试时,失败的测试是红色,通过的是绿色。

红绿循环三步走:

  1. 写一个失败的测试(红)——先想清楚你要实现什么功能,然后写一个会失败的测试用例。
  2. 让测试通过(绿)——写最简的代码,只要能让测试通过就行,别想太多。
  3. 重构代码(重构)——在测试的保护下,放心地优化代码结构。

你想想看,这个循环的好处是什么?它逼着你先把「做什么」想清楚,再动手「怎么做」。我在项目中遇到过很多次,开发到一半发现需求理解错了,就是因为没先写测试。

来看个简单的例子。假设我们要实现一个计算器类,先写测试:

// test_calculator.cpp
#include <gtest/gtest.h>
#include "calculator.h"

TEST(CalculatorTest, AddTwoNumbers) {
    Calculator calc;
    EXPECT_EQ(5, calc.add(2, 3));
}

TEST(CalculatorTest, AddNegativeNumbers) {
    Calculator calc;
    EXPECT_EQ(-1, calc.add(2, -3));
}

这时候跑测试,肯定是红的——因为Calculator类还没写呢。然后我们写最简的实现:

// calculator.h
class Calculator {
public:
    int add(int a, int b) {
        return a + b;
    }
};

测试变绿了。嗯,这时候别急着高兴,看看代码有没有可以优化的地方。比如这个类以后可能要支持更多运算,是不是该考虑接口设计?但记住,重构阶段不要改功能,只改结构。

我的小习惯:每次写完一个测试用例,我都会问自己:「这个测试真的能测出问题吗?」有时候写出来的测试太「完美」,反而测不出边界情况。我建议你多写几个边界测试,比如空值、最大值、负数等。

12.2 Mock对象:用Google Mock隔离依赖

实际项目中,很少有类能独立工作。它们往往依赖数据库、网络、文件系统等外部组件。这时候直接写单元测试就很痛苦——你总不能每次跑测试都连数据库吧?

解决方案就是Mock对象。说白了,就是造一个「假」的依赖对象,让它按照我们期望的方式工作。

Google Mock(简称gmock)是C++社区最流行的Mock框架之一。它和Google Test配合得天衣无缝。

12.2.1 什么时候需要Mock?

我总结了几种典型场景:

  • 外部服务不可控——比如支付接口、短信服务,你总不能每次测试都真的发一条短信吧?
  • 环境依赖——文件系统、数据库、网络等,测试环境可能没有这些资源。
  • 难以构造的对象——比如需要大量配置才能创建的对象,Mock可以简化。
  • 需要验证交互行为——比如某个方法是否被调用、调用了多少次、传入了什么参数。

注意:Mock不是万能的。我曾经见过一个项目,Mock用得太多,导致测试和实现耦合太紧——改一行实现,要改十个Mock。记住:Mock应该模拟行为,而不是实现细节。

12.2.2 用gmock写一个Mock类

假设我们有一个数据库接口:

// database.h
class Database {
public:
    virtual ~Database() = default;
    virtual bool connect(const std::string& url) = 0;
    virtual int query(const std::string& sql) = 0;
};

用gmock生成Mock类:

// mock_database.h
#include <gmock/gmock.h>
#include "database.h"

class MockDatabase : public Database {
public:
    MOCK_METHOD(bool, connect, (const std::string& url), (override));
    MOCK_METHOD(int, query, (const std::string& sql), (override));
};

然后在测试中,我们可以控制Mock的行为:

TEST(UserServiceTest, GetUserById) {
    MockDatabase mock_db;
    
    // 设置期望:connect应该被调用一次,返回true
    EXPECT_CALL(mock_db, connect("localhost:3306"))
        .Times(1)
        .WillOnce(testing::Return(true));
    
    // 设置期望:query应该被调用,返回用户数据
    EXPECT_CALL(mock_db, query("SELECT * FROM users WHERE id=1"))
        .Times(1)
        .WillOnce(testing::Return(1));  // 假设返回用户ID
    
    UserService service(&mock_db);
    auto user = service.getUserById(1);
    
    EXPECT_EQ(user.id, 1);
}

你看,这样我们就能在不连接真实数据库的情况下,测试UserService的逻辑了。

避坑指南:我曾经犯过一个错误——在Mock中设置了过于严格的期望。比如用.Times(Exactly(1)),结果重构代码时多调用了一次,测试就挂了。后来我改用.Times(AtLeast(1)),给重构留点余地。

12.3 测试覆盖率:别被数字骗了

测试覆盖率,说白了就是「你的代码有多少被测试执行到了」。常见的指标有:

覆盖率类型 含义 我的看法
行覆盖率 代码行被执行的百分比 最基础,但容易造假
分支覆盖率 if/else等分支被覆盖的百分比 比行覆盖率更有价值
函数覆盖率 函数被调用的百分比 适合检查遗漏
路径覆盖率 所有可能执行路径的覆盖 理论上最好,但成本太高

我见过不少团队,把「行覆盖率90%」当成KPI。结果呢?测试全是些「快乐路径」,边界条件一个都没测。你想想看,这种覆盖率有什么意义?

我的原则:

  • 核心逻辑必须覆盖——比如支付、权限、数据校验等。
  • 边界条件比正常路径重要——空指针、越界、并发冲突等。
  • 不要追求100%——有些代码(比如日志、配置加载)不值得花时间写测试。

12.3.1 如何测量覆盖率?

C++常用的覆盖率工具有gcov(配合GCC)、lcov(生成HTML报告)。基本用法:

# 编译时加覆盖率选项
g++ -fprofile-arcs -ftest-coverage test.cpp -o test

# 运行测试
./test

# 生成覆盖率报告
gcov test.cpp
lcov --capture --directory . --output-file coverage.info
genhtml coverage.info --output-directory coverage_report

然后打开coverage_report/index.html,就能看到哪些代码被覆盖了,哪些没有。

注意:覆盖率工具本身有性能开销。我建议只在CI/CD环境中启用覆盖率检查,不要在开发环境一直开着。否则编译速度会慢得让你抓狂。

12.4 实战建议:TDD在C++项目中的落地

说了这么多,最后给几条实战建议:

  1. 从小处开始——别想着一下子把所有代码都覆盖。选一个核心模块,先写几个关键测试,感受一下TDD的节奏。
  2. 测试和代码一起评审——我习惯在Code Review时,先看测试再看实现。如果测试写得不好,实现大概率也有问题。
  3. Mock要适度——能用真实对象就用真实对象,Mock只用来隔离外部依赖。我见过一个项目,Mock了十几个类,最后测试比实现还难维护。
  4. 覆盖率是手段,不是目标——别为了凑数字而写无意义的测试。我宁愿要80%的有意义覆盖,也不要100%的垃圾测试。

嗯,最后说一句:TDD不是银弹。它不能保证你的代码没有bug,但它能让你在修改代码时更有底气。至少,当你重构一个模块时,看到满屏的绿色测试通过,心里会踏实很多。

下一章,我们会聊聊持续集成和自动化测试。到时候再分享一些我在CI流水线中踩过的坑。