C++如何进行单元测试_C++ Google Test (gtest)框架入门指南

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

C++如何进行单元测试_C++ Google Test (gtest)框架入门指南

2025-12-13

浏览次数：次

返回列表

首先介绍如何使用CMake集成Google Test并编写测试用例，接着演示通过TEST宏定义测试套件与用例，利用EXPECT_EQ验证结果，并展示运行输出及命令行参数控制测试执行流程。

c++如何进行单元测试_c++ google test (gtest)框架入门指南

在C++开发中，单元测试是保证代码质量的重要手段。Google Test（简称 gtest）是目前最流行的C++单元测试框架之一，由Google开源，支持跨平台，使用简单且功能强大。本文将带你快速上手如何用 gtest 编写和运行C++单元测试。

安装与配置 Google Test

gtest 支持多种方式集成到项目中，常见方法有源码编译、包管理器安装或通过 CMake 自动获取。

使用 CMake 集成（推荐方式）：

在项目的 CMakeLists.txt 中添加以下内容：

cmake_minimum_required(VERSION 3.14)
project(MyTestProject)
<h1>启用 C++17</h1><p>set(CMAKE_CXX_STANDARD 17)</p><h1>使用 FetchContent 获取 gtest</h1><p>include(FetchContent)
FetchContent_Declare(
googletest
URL <a href="https://www.php.cn/link/cb57ba36db3faf9723fcfeade897b7fb">https://www.php.cn/link/cb57ba36db3faf9723fcfeade897b7fb</a>
)
FetchContent_MakeAvailable(googletest)</p><h1>添加主程序或被测代码</h1><p>add_executable(mylib math.cpp)</p><h1>添加测试可执行文件</h1><p>enable_testing()
add_executable(test_math test_math.cpp)
target_link_libraries(test_math gtest_main mylib)</p><h1>注册测试</h1><p>include(GoogleTest)
gtest_discover_tests(test_math)</p>

这样 CMake 会在构建时自动下载并编译 gtest，无需手动安装。

编写第一个测试用例

假设我们有一个简单的加法函数需要测试：

math.h

#ifndef MATH_H
#define MATH_H
int add(int a, int b);
#endif

math.cpp

#include "math.h"
int add(int a, int b) {
    return a + b;
}

test_math.cpp（测试文件）

#include <gtest/gtest.h>
#include "math.h"
<p>// 测试用例：测试 add 函数
TEST(MathTest, AddPositiveNumbers) {
EXPECT_EQ(add(2, 3), 5);
EXPECT_EQ(add(0, 0), 0);
}</p><p>TEST(MathTest, AddNegativeNumbers) {
EXPECT_EQ(add(-1, -1), -2);
EXPECT_EQ(add(-5, 3), -2);
}</p>

说明：

TEST(测试套件名, 测试用例名) 定义一个测试。
EXPECT_EQ(实际值, 期望值) 判断是否相等，不通过仅记录错误，继续执行。
若想中断测试可用 ASSERT_EQ。

运行测试并查看结果

构建项目后运行测试可执行文件（如 test_math），输出类似：

[ RUN      ] MathTest.AddPositiveNumbers
[       OK ] MathTest.AddPositiveNumbers (0 ms)
[ RUN      ] MathTest.AddNegativeNumbers
[       OK ] MathTest.AddNegativeNumbers (0 ms)
<p>SUCCESS: All tests passed.</p>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/1155">
                            <img src="https://img.php.cn/upload/ai_manual/000/000/000/175680114120401.png" alt="Figma">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/1155">Figma</a>
                            <p>Figma 是一款基于云端的 UI 设计工具，可以在线进行产品原型、设计、评审、交付等工作。</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="Figma">
                                <span>1371</span>
                            </div>
                        </div>
                        <a href="/ai/1155" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="Figma">
                        </a>
                    </div>

如果某个断言失败，gtest 会打印具体哪一行出错、期望值与实际值，便于调试。

你也可以使用命令行参数控制测试行为，例如：

--gtest_filter=MathTest.*：只运行 MathTest 套件下的测试。
--gtest_list_tests：列出所有测试用例。
--gtest_repeat=5：重复执行5次。

高级特性简要介绍

gtest 提供丰富的测试功能，以下是常用扩展：

1. 参数化测试（Parametrized Tests）

适用于对同一函数用多组输入进行测试：

class AddTest : public ::testing::TestWithParam<std::tuple<int, int, int>> {};
<p>TEST_P(AddTest, AllCases) {
int a = std::get<0>(GetParam());
int b = std::get<1>(GetParam());
int expected = std::get<2>(GetParam());
EXPECT_EQ(add(a, b), expected);
}</p><p>INSTANTIATE_TEST_SUITE_P(
NormalCases, AddTest,
::testing::Values(
std::make_tuple(2, 3, 5),
std::make_tuple(-1, 1, 0),
std::make_tuple(0, 0, 0)
)
);</p>

2. 测试夹具（Test Fixtures）

当多个测试需要共享初始化/清理逻辑时使用：

class DatabaseTest : public ::testing::Test {
protected:
    void SetUp() override {
        // 初始化资源，如打开数据库连接
    }
<pre class="brush:php;toolbar:false;"><code>void TearDown() override {
    // 清理资源
}

// 可定义共用数据成员