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

这里要注意 EXPECT_EQ 和 ASSERT_EQ 的区别，前者继续执行后续断言，后者遇到失败立即终止当前测试用例。

Catch2

如果你偏好更简洁的语法，Catch2 是个不错的选择，它支持 BDD 风格描述。

安装指南

# Ubuntu/Debian
sudo apt-get install catch2

# macOS (Homebrew)
brew install catch2

代码示例

#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 Add Test", "[add]") {
    MyClass obj;
    obj.setValue(10);
    int result = obj.add(20);
    REQUIRE(result == 30);
}

使用 REQUIRE 宏会在条件不满足时抛出异常，适合用于前置条件检查。

调试工具实战

当测试未通过或程序崩溃时，调试器是解决问题的关键。

GDB (Linux 环境)

GDB 功能强大，但命令行操作需要一定熟练度。

基本命令速查

# 编译时添加调试信息
g++ -g program.cpp -o program

# 启动调试
gdb program

# 常用指令
break main          # 在 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;
}

在 main 处打断点，观察 result 的值是否符合预期，如果不符合，可以通过 step 逐行排查逻辑错误。

Visual Studio 调试器

Windows 环境下，VS 提供了图形化界面，对新手更友好。

操作步骤

1. 在代码行号左侧点击设置断点。
2. 按 F5 启动调试模式。
3. 程序暂停时，利用'监视'窗口查看变量状态。
4. 使用调用堆栈窗口分析函数调用路径。

集成测试的重要性

单元测试只能保证局部正确，集成测试则关注模块间的接口契约。常见的集成策略包括自顶向下、自底向上以及三明治混合模式。

示例：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.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

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.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("无效的运算符");
    }
}

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

使用 ctest 可以一键运行所有测试用例，方便集成到 CI 流程中。

总结与进阶方向

测试与调试不是一次性工作，而是伴随开发周期的持续过程。通过本文，我们了解了单元测试框架的选择、调试工具的实操以及集成测试的设计思路。

下一步建议

• 尝试引入 Google Mock 进行依赖隔离测试。
• 学习使用 gcov 或 lcov 生成代码覆盖率报告。
• 探索 Clang Static Analyzer 进行静态代码分析。
• 将测试脚本接入 GitHub Actions 实现自动化流水线。

好的代码不仅在于功能实现，更在于其可验证性和可维护性。希望这些经验能帮助你在 C++ 道路上走得更稳。