第12章:测试驱动开发(TDD):红绿循环、Mock对象(Google Mock)、测试覆盖率
说实话,我刚入行那几年,对测试的态度是「能省则省」。总觉得写测试浪费时间,有那功夫不如多写几行业务代码。直到有一次,我负责的一个支付模块,因为一个边界条件没处理好,线上出了严重事故。那天晚上我盯着屏幕,看着日志里那一串串异常,心里只有一个念头:如果当初写了单元测试,这问题早该发现了。
从那以后,我成了测试驱动开发(TDD)的忠实拥趸。今天我们就来聊聊TDD的核心实践,以及C++项目中怎么用好它。
12.1 红绿循环:TDD的节奏感
TDD的核心,说白了就是三个步骤的循环:红 → 绿 → 重构。我习惯叫它「红绿循环」,因为每次跑测试时,失败的测试是红色,通过的是绿色。
红绿循环三步走:
- 写一个失败的测试(红)——先想清楚你要实现什么功能,然后写一个会失败的测试用例。
- 让测试通过(绿)——写最简的代码,只要能让测试通过就行,别想太多。
- 重构代码(重构)——在测试的保护下,放心地优化代码结构。
你想想看,这个循环的好处是什么?它逼着你先把「做什么」想清楚,再动手「怎么做」。我在项目中遇到过很多次,开发到一半发现需求理解错了,就是因为没先写测试。
来看个简单的例子。假设我们要实现一个计算器类,先写测试:
// 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++项目中的落地
说了这么多,最后给几条实战建议:
- 从小处开始——别想着一下子把所有代码都覆盖。选一个核心模块,先写几个关键测试,感受一下TDD的节奏。
- 测试和代码一起评审——我习惯在Code Review时,先看测试再看实现。如果测试写得不好,实现大概率也有问题。
- Mock要适度——能用真实对象就用真实对象,Mock只用来隔离外部依赖。我见过一个项目,Mock了十几个类,最后测试比实现还难维护。
- 覆盖率是手段,不是目标——别为了凑数字而写无意义的测试。我宁愿要80%的有意义覆盖,也不要100%的垃圾测试。
嗯,最后说一句:TDD不是银弹。它不能保证你的代码没有bug,但它能让你在修改代码时更有底气。至少,当你重构一个模块时,看到满屏的绿色测试通过,心里会踏实很多。
下一章,我们会聊聊持续集成和自动化测试。到时候再分享一些我在CI流水线中踩过的坑。