开源推荐｜C++ 轻量级单元测试框架，自带健康码报告太香了！

大家好，今天给大家推荐一个我自制的 C++ 轻量级单元测试框架——cpp-test-framework，已开源至 GitHub，MIT 协议可自由使用、二次开发，适合中小型 C++ 项目快速接入单元测试，新手也能轻松上手～

做 C++ 开发的同学都知道，单元测试是保证代码质量的关键，但很多成熟框架（比如 Google Test）配置复杂、依赖繁多，对于小型项目或快速验证场景来说过于笨重。所以我结合自己的开发习惯，做了这个轻量、简洁、自带“健康码”趣味报告的单元测试框架，零依赖、单头文件，开箱即用！

🌟 项目核心亮点

不同于传统测试框架的繁琐，这个框架主打“轻量+实用+趣味”，核心亮点如下，每一个都戳中开发痛点：

• 零依赖、单头文件：无需配置 CMake、无需安装第三方库，仅一个 test_frame.h 头文件，直接 #include 就能使用，移植性拉满，嵌入式、控制台项目都能无缝接入。

• 彩色可视化输出：PASS 用例绿色标注，FAIL 用例红色标注，视觉区分清晰，一眼就能定位失败用例，不用在密密麻麻的日志里找错误，提升调试效率。

• 健康码分级报告：这是最有特色的功能！测试结束后自动生成“健康码”报告——全过是绿码、部分失败是黄码、全失败是红码，生动直观，再也不用盯着枯燥的数字看通过率。

• 自动统计+析构魔法：无需手动调用报告打印接口，析构函数自动触发统计，输出总用例数、通过数、失败数、通过率（保留2位小数），还能统计 run() 调用次数，懒人福音。

• 支持多次测试累加：可多次调用 run() 方法，测试用例自动累加统计，适合分模块测试、批量验证场景，灵活度拉满。

• 未测试友好提示：如果未调用任何测试用例，会给出“还没有测试过”的提示，避免空报告输出，细节拉满。

📁 项目结构（简洁规范）

项目结构遵循开源项目规范，清晰易懂，方便后续扩展和维护，具体如下：

cpp-test-framework/
├── LICENSE              # MIT 开源协议（可自由使用、分发）
├── test_frame.h         # 核心测试框架头文件（仅1个，零依赖）
├── README.md            # 项目说明、使用教程
└── example/
    └── demo.cpp         # 示例代码，快速上手参考

这种结构既符合 C++ 开源项目的常规规范，也方便新手快速找到核心文件，无需复杂的目录导航。

💻 快速上手教程（3步搞定）

新手也能秒上手，无需复杂配置，跟着下面3步走，轻松实现单元测试：

第一步：下载项目

直接从 GitHub 克隆项目，或下载压缩包解压，核心文件仅 test_frame.h，可直接复制到自己的项目中使用：

git clone https://github.com/dxiangwiki/cpp-test-framework.git

第二步：引入头文件

在自己的测试文件中，直接引入核心头文件，无需额外配置：

#include "test_frame.h"  // 仅需这一行，无需其他依赖

第三步：编写测试用例，运行测试

定义测试用例组，创建测试对象，调用run() 方法即可，示例代码如下（完整示例见example/demo.cpp）：

#include "../test_frame.h"

int main() {
    // 1. 定义测试用例组（输入、预期输出、实际输出）
    TestGroup<int, int> tests = {
        {1, 2, 2},    // 输入1，预期2，实际2 → PASS
        {2, 4, 5},    // 输入2，预期4，实际5 → FAIL
        {3, 6, 6}     // 输入3，预期6，实际6 → PASS
    };

    // 2. 创建测试对象，运行测试
    TEST<int, int> tester;
    tester.run(tests);

    return 0;
}

📸 运行效果展示

运行上述示例代码，控制台会输出彩色用例结果和健康码报告，效果如下（直观又清晰）：

[PASS] 输入:1 预期:2 实际:2
[FAIL] 输入:2 预期:4 实际:5
[PASS] 输入:3 预期:6 实际:6

===== 测试自动汇总报告 =====
run() 调用次数：1
总用例数：3
通过用例：2
失败用例：1
通过率：66.67 %
----------------------------
⚠️ 黄码警告！存在失败用例，请尽快排查修复！
============================

三种健康码状态对应不同场景，一目了然：

• 🟢 绿码：全用例通过 → 代码一切正常，一路绿灯！

• 🟡 黄码：部分用例失败 → 存在隐患，需排查修复！

• 🔴 红码：全用例失败 → 代码异常，禁止通行！

🔧 核心功能拆解

很多同学可能好奇框架的核心实现，这里简单拆解2个关键功能，帮助大家理解（详细源码见 test_frame.h）：

1. 彩色输出实现

利用控制台 ANSI 颜色码，实现 PASS/FAIL 不同颜色标注，无需第三方库，Windows、Linux、Mac 控制台均支持：

// 绿色：PASS
std::cout << "033[32m[PASS] 输入:" << tc.input << " 预期:" << tc.expect << " 实际:" << tc.actual << "033[0mn";
// 红色：FAIL
std::cout << "033[31m[FAIL] 输入:" << tc.input << " 预期:" << tc.expect << " 实际:" << tc.actual << "033[0mn";

2. 析构自动报告

利用 C++ 析构函数的生命周期特性，在测试对象销毁时（程序结束时）自动统计并打印报告，无需手动调用打印接口，实现“黑魔法”般的自动效果：

~TEST() {
    if (run_count == 0) {
        std::cout << "n033[33m[提示] 还没有测试过033[0mn";
        return;
    }
    // 统计并打印报告逻辑...
}

🌟 适用场景

这个框架主打轻量级，适合以下场景，完美替代笨重的大型测试框架：

• 中小型 C++ 项目、控制台项目、嵌入式项目的单元测试；

• 快速验证代码逻辑、批量测试简单接口/函数；

• 新手学习单元测试，无需复杂配置，快速上手；

• 需要简洁、直观的测试报告，不想面对繁琐日志的场景。

📌 开源地址 & 作者信息

项目已开源，MIT 协议，可自由使用、二次开发、分发，欢迎 Star、Fork、提 Issue，一起完善这个轻量级测试框架～

• GitHub 仓库：https://github.com/dxiangwiki/cpp-test-framework.git

• 作者：董翔（dxiangwiki）

• 邮箱：3631247406@qq.com

💡 最后说两句

这个框架从最初的一个简单模板类，慢慢优化出彩色输出、健康码报告、自动统计、未测试提示等功能，全程围绕“实用、简洁、有趣”的原则，没有多余的冗余代码，适合大多数 C++ 开发者的日常测试需求。

如果你的项目正需要一个轻量级的单元测试框架，不妨试试这个自带健康码的版本，上手简单、体验流畅；如果有优化建议，也欢迎在 GitHub 上提 Issue，一起打造更实用的 C++ 测试工具～

觉得有用的话，记得给 GitHub 仓库点个 Star，也欢迎转发分享给身边的 C++ 小伙伴，感谢支持！🙏

文章标签

#C++ #单元测试 #开源项目 #测试框架 #轻量级框架 #健康码测试