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

Catch2 框架

如果你偏好更简洁的语法，Catch2 是一个不错的选择。它同样功能强大，且易于上手。

安装指南

# 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 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 调试器

GDB 是 Linux 环境下最强大的命令行调试工具。编译时务必加上 -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 开发者，Visual Studio 提供的图形化界面更加直观。支持断点、变量监视、调用栈查看等功能。基本流程是在代码行号处点击设置断点，按 F5 启动，然后在暂停状态下检查内存状态。

集成测试策略

基本概念

集成测试旨在验证模块间的接口和数据流。常见策略有自顶向下、自底向上以及三明治混合模式。选择哪种方式取决于你的架构依赖关系。

示例演示

#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 头文件

#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_H

Calculator 实现

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

主程序入口

#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;
}

构建与测试

使用 CMake 管理构建流程可以极大简化多文件项目的编译。

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

总结与进阶

通过本章的学习，我们掌握了从单元测试到集成测试的全流程，并熟悉了 GDB 等调试工具的使用。在实际工作中，建议养成编写测试驱动开发的习惯，这能显著降低回归错误的概率。

后续练习建议

1. 尝试用 Google Test 测试链表数据结构。
2. 利用 GDB 排查一个存在内存泄漏的程序。
3. 研究 Google Mock 在模拟依赖对象时的用法。
4. 引入 gcov 分析代码覆盖率。
5. 配置 GitHub Actions 实现持续集成自动测试。

保持对质量的敬畏，代码才能走得更远。