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 实战建议

说了这么多,到底怎么选?我给你三个场景:

  1. 大型企业项目(10万行以上):选Google Test。生态最全,GMock内置,CI集成方便。我目前在带的一个50万行项目,就是用GTest。
  2. 中小型项目或新项目:选Catch2。上手快,语法现代,BDD风格写起来很舒服。
  3. 已经在用Boost的项目:选Boost.Test。少一个依赖,少一份麻烦。

最后说一句:框架只是工具,真正重要的是「写测试」这个习惯。我见过太多团队,框架选得再好,最后也没写几个测试。记住,测试不是给老板看的,是给你自己留的后路。

下一章,咱们聊聊如何把单元测试集成到CI/CD流水线里。到时候我会分享一个真实的案例——一个项目因为测试覆盖率从10%提到80%,线上bug减少了多少。