0

0

C++如何实现一个简单的单元测试框架_从零开始构建一个支持断言的C++测试工具

裘德小鎮的故事

裘德小鎮的故事

发布时间:2025-12-14 19:36:37

|

830人浏览过

|

来源于php中文网

原创

一个简易C++单元测试框架可通过注册测试函数、自定义断言宏实现;使用std::function存储测试用例,通过全局构造对象注册,每个测试在try-catch中执行,断言失败时输出信息并计数,确保所有用例运行完毕后统一报告结果。

c++如何实现一个简单的单元测试框架_从零开始构建一个支持断言的c++测试工具

写C++程序时,手动验证函数行为既费时又容易出错。一个简单的单元测试框架能自动运行测试用例、检查结果并报告失败。从零开始构建一个支持断言的测试工具并不复杂,关键在于组织测试用例、捕获断言结果和输出清晰信息。

设计基本结构:测试用例与运行器

先定义测试的基本单元——测试用例。每个测试是一个函数,注册到全局管理器中,在程序启动时统一执行。

使用函数指针或std::function来存储测试函数,配合一个注册机制:

  • 定义 Test 类型:using Test = std::function;
  • 维护一个全局 vector 存放所有测试用例
  • 提供宏 REGISTER_TEST(name) 来注册函数

通过构造全局对象触发注册,比如在 main 之前完成收集。

立即学习C++免费学习笔记(深入)”;

实现断言机制:捕获失败但不停止

标准 assert 在失败时终止程序,不适合批量测试。需要自定义 ASSERT_EQ、ASSERT_TRUE 等宏,记录错误但继续执行。

思路是抛异常或设置标志位。这里推荐使用局部 try-catch 配合布尔标记:

  • 每个测试函数运行在一个作用域
  • 断言失败时输出错误信息,增加失败计数
  • 不中断当前测试,允许执行完所有检查点

例如:

#define ASSERT_EQ(actual, expected) \
  do { \
    if ((actual) != (expected)) { \
      std::cerr << "FAIL: " << #actual << " == " << #expected \
                << " in " << __FILE__ << ":" << __LINE__ << "\n"; \
      test_failed = true; \
    } \
  } while(0)

运行测试并输出结果

main 函数调用测试运行器,遍历所有注册的测试,逐个执行并统计结果。

LobeHub
LobeHub

LobeChat brings you the best user experience of ChatGPT, OLLaMA, Gemini, Claude

下载

每项测试包含名称和函数体,可封装为结构体:

struct TestCase {
  std::string name;
  Test func;
};

运行时打印测试名,捕获异常(如断言抛出),汇总通过/失败数量。

示例输出:

Running test_addition... OK
Running test_subtraction... FAILED (1 assertion failed)

简化测试编写:宏定义接口

让用户用类似 TEST(TestCaseName, TestName) 定义测试,提升可读性。

实现方式:

  • 定义宏展开为一个函数和一个注册语句
  • 利用静态变量确保只注册一次

例如:

#define TEST(suite_name, test_name) \
  void test_##suite_name##_##test_name(); \
  struct Register_##suite_name##_##test_name { \
    Register_##suite_name##_##test_name() { \
      add_test(#suite_name "." #test_name, test_##suite_name##_##test_name); \
    } \
  }; \
  static Register_##suite_name##_##test_name reg_##suite_name##_##test_name; \
  void test_##suite_name##_##test_name()

用户只需写 TEST(Math, Addition) { ... },即可自动注册。

基本上就这些。这个轻量框架没有外部依赖,编译即用,适合嵌入小型项目。随着需求增长,可扩展超时控制、参数化测试等功能。关键是理解测试生命周期:注册、执行、断言、报告。

相关专题

更多
golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

197

2025.06.09

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

189

2025.07.04

javascriptvoid(o)怎么解决
javascriptvoid(o)怎么解决

javascriptvoid(o)的解决办法:1、检查语法错误;2、确保正确的执行环境;3、检查其他代码的冲突;4、使用事件委托;5、使用其他绑定方式;6、检查外部资源等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

175

2023.11.23

java中void的含义
java中void的含义

本专题整合了Java中void的相关内容,阅读专题下面的文章了解更多详细内容。

97

2025.11.27

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

1027

2023.10.19

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

66

2025.10.17

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

455

2025.12.29

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

11

2026.01.19

Java编译相关教程合集
Java编译相关教程合集

本专题整合了Java编译相关教程,阅读专题下面的文章了解更多详细内容。

5

2026.01.21

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
React 教程
React 教程

共58课时 | 3.9万人学习

Pandas 教程
Pandas 教程

共15课时 | 0.9万人学习

ASP 教程
ASP 教程

共34课时 | 3.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号