C++ 测试与调试实战：保障代码质量与稳定性

Catch2 框架

如果你偏好更简洁的语法，Catch2 是个不错的选择，它支持单文件头库模式，部署方便。

安装指南

# Ubuntu/Debian
sudo apt-get install catch2

# macOS (Homebrew)
brew install catch2

示例代码

Catch2 使用 REQUIRE 进行强断言，一旦失败立即中断当前测试用例。

#define CATCH_CONFIG_MAIN
#include <catch2/catch.hpp>
#include "MyClass.h"

TEST_CASE("MyClass Constructor Test", "[constructor]") {
    MyClass obj;
    REQUIRE(obj.getValue() == 0);
}

TEST_CASE("MyClass Set and Get Value Test", "[setget]") {
    MyClass obj;
    obj.setValue(42);
    REQUIRE(obj.getValue() == 42);
}

TEST_CASE("MyClass Add Test", "[add]") {
    MyClass obj;
    obj.setValue(10);
    int result = obj.add(20);
    REQUIRE(result == 30);
    REQUIRE(obj.getValue() == 30);
}

调试工具实战

当测试未通过时，调试器是找出真相的关键。

GDB 调试器

Linux 环境下 GDB 是首选。编译时必须加上 -g 参数以保留调试信息。

常用命令速查

# 启动调试
gdb program

# 设置断点
break main

# 运行程序
run

# 单步执行（不进入函数）
next

# 单步执行（进入函数）
step

# 查看变量值
print variable

# 查看调用栈
backtrace

# 继续执行
continue

# 退出
quit

调试示例

假设程序崩溃了，我们可以这样排查：

#include <iostream>
#include "MyClass.h"

int main() {
    MyClass obj;
    obj.setValue(42);
    int result = obj.add(20);
    std::cout << "结果：" << result << std::endl;
    return 0;
}

Visual Studio 调试器

Windows 开发者可以直接利用 IDE 内置的强大功能。相比命令行，VS 提供了可视化窗口，可以直观地观察内存变化、线程状态和调用堆栈。

操作要点

1. 在代码行号左侧点击设置断点
2. 按 F5 启动调试会话
3. 程序暂停时，鼠标悬停查看变量实时值
4. 使用'调用堆栈'窗口分析函数调用链
5. 逐步执行（F10/F11）定位逻辑错误

集成测试策略

单元测试虽然重要，但无法保证模块组合后的正确性。集成测试专注于接口交互和数据流。

常见策略

• 自顶向下：先测主流程，桩模块模拟底层
• 自底向上：先测底层工具，驱动模块模拟上层
• 三明治集成：结合两者优势

示例

下面展示了 Calculator 和 Parser 模块的集成测试，重点在于验证解析后的表达式能否被正确计算。

#include <gtest/gtest.h>
#include "Calculator.h"
#include "Parser.h"

TEST(IntegrationTest, CalculateTest) {
    Calculator calculator;
    Parser parser;

    // 测试加法
    std::string expression = "10 + 20";
    int result = parser.parse(expression);
    EXPECT_EQ(result, 30);

    // 测试乘法
    expression = "10 * 20";
    result = parser.parse(expression);
    EXPECT_EQ(result, 200);

    // 测试括号优先级
    expression = "(10 + 20) * 3";
    result = parser.parse(expression);
    EXPECT_EQ(result, 90);
}

综合案例：计算器项目

为了将上述知识串联起来，我们构建一个包含头文件、源文件、测试文件和构建脚本的完整项目。

项目结构

清晰的目录结构有助于团队协作和维护：

CalculatorProject/
├── include/
│   ├── Calculator.h
│   └── Parser.h
├── src/
│   ├── Calculator.cpp
│   ├── Parser.cpp
│   └── main.cpp
├── tests/
│   ├── CalculatorTest.cpp
│   ├── ParserTest.cpp
│   └── IntegrationTest.cpp
└── CMakeLists.txt

核心实现

Calculator 模块

实现了基本的加减乘除，特别注意除零保护。

// include/Calculator.h
#ifndef CALCULATOR_H
#define CALCULATOR_H

class Calculator {
public:
    static int add(int a, int b);
    static int subtract(int a, int b);
    static int multiply(int a, int b);
    static int divide(int a, int b);
};

#endif

// src/Calculator.cpp
#include "Calculator.h"
#include <stdexcept>

int Calculator::add(int a, int b) {
    return a + b;
}

int Calculator::subtract(int a, int b) {
    return a - b;
}

int Calculator::multiply(int a, int b) {
    return a * b;
}

int Calculator::divide(int a, int b) {
    if (b == 0) {
        throw std::invalid_argument("除数不能为零");
    }
    return a / b;
}

Parser 模块

负责解析简单的字符串表达式。

// include/Parser.h
#ifndef PARSER_H
#define PARSER_H

#include <string>
#include "Calculator.h"

class Parser {
public:
    int parse(const std::string& expression);
};

#endif

// src/Parser.cpp
#include "Parser.h"
#include <sstream>

int Parser::parse(const std::string& expression) {
    std::istringstream iss(expression);
    int a, b;
    char op;
    iss >> a >> op >> b;
    
    switch (op) {
        case '+': return Calculator::add(a, b);
        case '-': return Calculator::subtract(a, b);
        case '*': return Calculator::multiply(a, b);
        case '/': return Calculator::divide(a, b);
        default: throw std::invalid_argument("无效的运算符");
    }
}

主程序入口

// src/main.cpp
#include <iostream>
#include "Parser.h"

int main() {
    Parser parser;
    try {
        std::string expression;
        std::cout << "请输入表达式（例如：10 + 20）: ";
        std::getline(std::cin, expression);
        
        int result = parser.parse(expression);
        std::cout << "结果：" << result << std::endl;
    } catch (const std::exception& e) {
        std::cerr << "错误：" << e.what() << std::endl;
        return 1;
    }
    return 0;
}

测试与构建

测试代码示例

// tests/CalculatorTest.cpp
#include <gtest/gtest.h>
#include "Calculator.h"

TEST(CalculatorTest, DivideTest) {
    EXPECT_EQ(Calculator::divide(20, 10), 2);
    EXPECT_THROW(Calculator::divide(10, 0), std::invalid_argument);
}

CMake 配置

使用 CMake 管理构建过程，并集成 Google Test。

# CMakeLists.txt
cmake_minimum_required(VERSION 3.10)
project(CalculatorProject)

set(CMAKE_CXX_STANDARD 17)
include_directories(include)

# 添加库
add_library(Calculator src/Calculator.cpp)
add_library(Parser src/Parser.cpp)

# 添加主程序
add_executable(CalculatorApp src/main.cpp)
target_link_libraries(CalculatorApp Calculator Parser)

# 添加测试子目录
add_subdirectory(tests)

# tests/CMakeLists.txt
cmake_minimum_required(VERSION 3.10)
find_package(GTest REQUIRED)
include_directories(${GTEST_INCLUDE_DIRS})

add_executable(CalculatorTests CalculatorTest.cpp ParserTest.cpp IntegrationTest.cpp)
target_link_libraries(CalculatorTests ${GTEST_LIBRARIES} Calculator Parser pthread)

include(GoogleTest)
gtest_discover_tests(CalculatorTests)

构建与运行

mkdir -p build && cd build
cmake ..
make
ctest

总结与进阶

本章我们梳理了 C++ 测试与调试的核心链路。从理论上的测试分类，到 Google Test 的具体实践，再到 GDB 的底层调试，最后通过计算器项目完成了端到端的演练。

后续练习建议

1. 尝试用 Google Mock 对依赖外部接口的类进行隔离测试
2. 引入 Google Benchmark 对比不同算法的性能差异
3. 配置 CI 流水线（如 GitHub Actions），每次提交自动运行测试
4. 学习 gcov 生成代码覆盖率报告，查漏补缺

保持测试意识，让代码在迭代中依然稳健可靠。