CppUTest完全指南：从零基础到精通C/C++单元测试框架

【免费下载链接】cpputest CppUTest unit testing and mocking framework for C/C++ 项目地址: https://gitcode.com/gh_mirrors/cp/cpputest

CppUTest是一个轻量级的C/C++单元测试和模拟框架，专为嵌入式系统和桌面应用开发设计。它提供了简洁的API和丰富的断言宏，帮助开发者快速构建可靠的测试用例，确保代码质量和稳定性。无论是小型项目还是大型应用，CppUTest都能轻松应对单元测试需求。

为什么选择CppUTest？

CppUTest作为一款成熟的单元测试框架，具有以下核心优势：

• 轻量级设计：极小的内存占用和快速的编译速度，特别适合资源受限的嵌入式环境
• 强大的断言库：提供超过50种断言宏，覆盖数值比较、字符串操作、内存检查等场景
• 模拟功能：内置Mock支持，轻松模拟复杂依赖组件
• 跨平台兼容：支持Windows、Linux、macOS及多种嵌入式平台
• 灵活的测试组织：支持测试套件、测试用例分组和测试过滤
• 丰富的输出格式：支持文本、JUnit、TeamCity等多种测试报告格式

快速开始：CppUTest环境搭建

1. 获取源码

git clone https://gitcode.com/gh_mirrors/cp/cpputest
cd cpputest

2. 编译安装

使用CMake（推荐）

mkdir build && cd build
cmake ..
make
sudo make install

使用Makefile

make -f Makefile_using_MakefileWorker

支持的平台工具链

CppUTest提供了多种平台的工具链配置文件，位于cmake/Toolchains/目录，包括：

• arm-none-eabi-gcc.toolchain.cmake
• clang+mingw-win32.toolchain.cmake
• clang+mingw-win64.toolchain.cmake
• ewarm-linux.toolchain.cmake

第一个CppUTest测试用例

基本测试结构

CppUTest测试用例遵循简单的结构：

#include "CppUTest/TestHarness.h"

TEST_GROUP(MyFirstTestGroup) {
    void setup() {
        // 测试前初始化代码
    }
    void teardown() {
        // 测试后清理代码
    }
};

TEST(MyFirstTestGroup, FirstTest) {
    int a = 1;
    int b = 1;
    CHECK_EQUAL(a, b);
}

核心断言宏

CppUTest提供了丰富的断言宏，常用的包括：

• CHECK(condition)：验证条件为真
• CHECK_EQUAL(expected, actual)：验证两个值相等
• CHECK_STR_EQUAL(expected, actual)：验证字符串相等
• CHECK_TRUE(condition)：验证条件为真
• CHECK_FALSE(condition)：验证条件为假
• FAIL(text)：强制测试失败并输出消息

完整的断言列表可参考include/CppUTest/UtestMacros.h

测试组织与运行

测试套件组织

将相关测试用例组织成测试组，便于管理和维护：

TEST_GROUP(StringUtilsTest) {
    StringUtils* utils;
    
    void setup() {
        utils = new StringUtils();
    }
    
    void teardown() {
        delete utils;
    }
};

TEST(StringUtilsTest, TrimWhitespace) {
    STRCMP_EQUAL("test", utils->trim("  test  "));
}

TEST(StringUtilsTest, SplitString) {
    auto parts = utils->split("a,b,c", ',');
    CHECK_EQUAL(3, parts.size());
}

运行测试

编译测试程序后，可通过命令行运行并支持多种参数：

# 运行所有测试
./MyTestProgram

# 只运行特定测试组
./MyTestProgram -g StringUtilsTest

# 生成JUnit格式报告
./MyTestProgram -ojunit

高级特性：Mock功能

CppUTest的Mock功能允许你创建模拟对象，验证函数调用和参数：

#include "CppUTestExt/MockSupport.h"

TEST_GROUP(NetworkClientTest) {
    void teardown() {
        mock().clear(); // 清除所有mock期望
    }
};

TEST(NetworkClientTest, SendData) {
    // 设置期望
    mock().expectOneCall("send_packet")
          .withParameter("data", "test data")
          .withParameter("length", 9)
          .andReturnValue(1);
          
    NetworkClient client;
    int result = client.send("test data");
    
    CHECK_EQUAL(1, result);
    mock().checkExpectations(); // 验证所有期望都已满足
}

更多Mock功能可参考include/CppUTestExt/MockSupport.h

实战案例：嵌入式系统测试

CppUTest特别适合嵌入式系统测试，通过platforms/目录下的平台适配代码，可以在多种嵌入式环境中运行测试：

1. 内存泄漏检测：通过MemoryLeakDetector.h自动检测内存泄漏
2. 硬件抽象：使用Mock模拟硬件接口，无需实际硬件即可测试驱动代码
3. 资源受限环境：针对嵌入式系统优化的内存使用

常见问题与解决方案

链接错误

如果遇到CppUTest库链接错误，确保正确链接CppUTest和CppUTestExt库：

g++ MyTests.cpp -o MyTests -lCppUTest -lCppUTestExt

测试执行顺序

测试用例的执行顺序是不确定的，确保每个测试用例都是独立的，不依赖执行顺序。

大型项目测试组织

对于大型项目，建议将测试代码放在单独的tests/目录，如项目中的tests/CppUTest/和tests/CppUTestExt/结构。

总结

CppUTest是一个功能强大且易于使用的C/C++单元测试框架，它能够帮助开发者构建可靠的测试用例，提高代码质量。通过本文介绍的基础知识和实战技巧，你已经具备了使用CppUTest进行单元测试的能力。开始编写你的第一个测试用例，体验测试驱动开发的魅力吧！

想要深入了解更多功能，可以参考项目中的示例代码examples/和详细文档。

【免费下载链接】cpputest CppUTest unit testing and mocking framework for C/C++ 项目地址: https://gitcode.com/gh_mirrors/cp/cpputest