11、单元测试框架:Google Test、Catch2、Boost.Test对比与实战
单元测试这件事,说实话,我见过太多团队把它当成「交作业」。写几个测试用例,跑一遍绿了,就完事了。但真正的大型项目里,单元测试是你的最后一道防线。今天咱们就聊聊三个主流框架:Google Test、Catch2、Boost.Test。我会结合我自己的踩坑经历,给你讲讲它们到底该怎么选、怎么用。
11.1 为什么需要单元测试框架?
你想想看,一个C++项目动辄几十万行代码。改一行逻辑,你怎么知道有没有把别的地方搞崩?
我十年前带过一个项目,团队十几个人,代码库大概30万行。那时候我们没上单元测试,全靠人工回归。结果呢?每次发版前通宵两天,还经常漏bug。后来我硬推了Google Test,三个月后,线上故障率降了70%。
单元测试框架能帮你做三件事:
- 自动验证:写一次,每次改代码都能跑
- 快速定位:哪个用例挂了,一眼就知道哪行代码有问题
- 文档即代码:好的测试用例,本身就是最好的使用文档
核心观点:没有单元测试的大型项目,就像没有安全绳的攀岩。你可能很厉害,但一次失误就完了。
11.2 Google Test:工业级首选
Google Test,简称GTest,是我个人用得最多的框架。为什么?因为它成熟、稳定、生态好。
11.2.1 基本用法
先看一个最简单的例子:
#include <gtest/gtest.h>
// 被测函数
int Add(int a, int b) {
return a + b;
}
// 测试用例
TEST(AddTest, PositiveNumbers) {
EXPECT_EQ(Add(1, 2), 3);
EXPECT_EQ(Add(10, 20), 30);
}
TEST(AddTest, NegativeNumbers) {
EXPECT_EQ(Add(-1, -2), -3);
EXPECT_EQ(Add(-5, 5), 0);
}
int main(int argc, char **argv) {
::testing::InitGoogleTest(&argc, argv);
return RUN_ALL_TESTS();
}
嗯,这里要注意:TEST宏的第一个参数是测试套件名,第二个是测试用例名。你可以把相关的测试放在同一个套件里。
11.2.2 断言宏
GTest提供了两套断言:
| 断言类型 | 致命(Fatal) | 非致命(Non-fatal) | 说明 |
|---|---|---|---|
| 相等 | ASSERT_EQ | EXPECT_EQ | 检查两个值相等 |
| 不等 | ASSERT_NE | EXPECT_NE | 检查两个值不等 |
| 真值 | ASSERT_TRUE | EXPECT_TRUE | 检查表达式为真 |
| 假值 | ASSERT_FALSE | EXPECT_FALSE | 检查表达式为假 |
| 浮点近似 | ASSERT_FLOAT_EQ | EXPECT_FLOAT_EQ | 浮点数比较,有容差 |
我的习惯:能用EXPECT就别用ASSERT。ASSERT一旦失败,整个测试用例就停了,你可能会错过后面的错误。只有当下面的代码依赖前面的结果时,才用ASSERT。
11.2.3 测试夹具(Test Fixture)
大型项目里,很多测试需要共享相同的初始化代码。这时候就用TEST_F:
class MyDatabaseTest : public ::testing::Test {
protected:
void SetUp() override {
// 每个测试用例开始前执行
db_.Open("test.db");
}
void TearDown() override {
// 每个测试用例结束后执行
db_.Close();
}
Database db_;
};
TEST_F(MyDatabaseTest, InsertRecord) {
db_.Insert("key1", "value1");
EXPECT_EQ(db_.Get("key1"), "value1");
}
TEST_F(MyDatabaseTest, DeleteRecord) {
db_.Insert("key1", "value1");
db_.Delete("key1");
EXPECT_TRUE(db_.IsEmpty());
}
我曾经在一个项目中,数据库的初始化代码有20多行。如果没有夹具,每个测试用例都得复制一遍,改起来想死的心都有。
11.3 Catch2:现代C++的优雅选择
Catch2是后起之秀。它的最大特点是「头文件只有头文件」,而且语法更现代。
11.3.1 基本用法
#define CATCH_CONFIG_MAIN
#include <catch2/catch.hpp>
int Multiply(int a, int b) {
return a * b;
}
TEST_CASE("Multiplication works", "[math]") {
REQUIRE(Multiply(2, 3) == 6);
REQUIRE(Multiply(0, 5) == 0);
REQUIRE(Multiply(-1, 1) == -1);
}
TEST_CASE("Edge cases", "[math][edge]") {
SECTION("Large numbers") {
REQUIRE(Multiply(1000, 1000) == 1000000);
}
SECTION("Zero") {
REQUIRE(Multiply(0, 0) == 0);
}
}
看到没?Catch2用TEST_CASE代替了TEST,用REQUIRE代替了ASSERT。而且它支持标签([math]),你可以只跑带某个标签的测试。
11.3.2 BDD风格
Catch2还支持行为驱动开发(BDD)风格:
SCENARIO("User login", "[auth]") {
GIVEN("A registered user") {
User user("alice", "password123");
WHEN("Correct password is provided") {
bool result = user.Login("password123");
THEN("Login succeeds") {
REQUIRE(result == true);
}
}
WHEN("Wrong password is provided") {
bool result = user.Login("wrongpass");
THEN("Login fails") {
REQUIRE(result == false);
}
}
}
}
这种写法,说白了就是让非技术人员也能看懂测试在测什么。我有个项目,产品经理都能直接读测试用例来确认需求。
避坑指南:Catch2的编译速度比GTest慢一些。如果你的项目特别大(比如超过50万行),建议先用GTest。我曾经在一个百万行级别的项目里用Catch2,单次编译多了3分钟,团队受不了。
11.4 Boost.Test:老牌劲旅
Boost.Test是Boost库的一部分。如果你已经在用Boost,那用它最省事。
11.4.1 基本用法
#define BOOST_TEST_MODULE MyTest
#include <boost/test/unit_test.hpp>
int Divide(int a, int b) {
return a / b;
}
BOOST_AUTO_TEST_SUITE(MathTests)
BOOST_AUTO_TEST_CASE(TestDivision) {
BOOST_CHECK_EQUAL(Divide(10, 2), 5);
BOOST_CHECK_EQUAL(Divide(9, 3), 3);
}
BOOST_AUTO_TEST_CASE(TestDivisionByZero) {
BOOST_CHECK_THROW(Divide(1, 0), std::runtime_error);
}
BOOST_AUTO_TEST_SUITE_END()
11.4.2 特点
- 丰富的断言:
BOOST_CHECK、BOOST_REQUIRE、BOOST_CHECK_EQUAL、BOOST_CHECK_THROW等 - 测试套件嵌套:支持多级
BOOST_AUTO_TEST_SUITE - 参数化测试:
BOOST_DATA_TEST_CASE - 依赖Boost:如果你没用Boost,引入它可能有点重
我的建议:如果你是新项目,而且没有用Boost,就别为了测试去引入Boost.Test。GTest或Catch2都更轻量。但如果你已经在用Boost,那Boost.Test是自然的选择。
11.5 三大框架对比
| 特性 | Google Test | Catch2 | Boost.Test |
|---|---|---|---|
| 安装难度 | 中等(需编译) | 简单(头文件) | 中等(需Boost) |
| 编译速度 | 快 | 中等 | 中等 |
| BDD支持 | 有限 | 优秀 | 一般 |
| 参数化测试 | 优秀 | 良好 | 良好 |
| Mock支持 | 内置GMock | 需第三方 | 需第三方 |
| 社区活跃度 | 最高 | 高 | 中等 |
| 大型项目经验 | 丰富 | 中等 | 丰富 |
11.6 实战建议
说了这么多,到底怎么选?我给你三个场景:
- 大型企业项目(10万行以上):选Google Test。生态最全,GMock内置,CI集成方便。我目前在带的一个50万行项目,就是用GTest。
- 中小型项目或新项目:选Catch2。上手快,语法现代,BDD风格写起来很舒服。
- 已经在用Boost的项目:选Boost.Test。少一个依赖,少一份麻烦。
最后说一句:框架只是工具,真正重要的是「写测试」这个习惯。我见过太多团队,框架选得再好,最后也没写几个测试。记住,测试不是给老板看的,是给你自己留的后路。
下一章,咱们聊聊如何把单元测试集成到CI/CD流水线里。到时候我会分享一个真实的案例——一个项目因为测试覆盖率从10%提到80%,线上bug减少了多少。