C++ 单元测试框架 Doctest：轻量级、零依赖的测试利器

icy 今天 2 抢沙发

默认

摘要： C++ 单元测试框架 Doctest：轻量级、零依赖的测试利器什么是 Doctest？ Doctest 是一个现代化的 C++ 单元测试框架，以其极简的设计理念和零外部依赖的特性...

C++ 单元测试框架 Doctest：轻量级、零依赖的测试利器

什么是 Doctest？

Doctest 是一个现代化的 C++ 单元测试框架，以其极简的设计理念和零外部依赖的特性而闻名。它最大的特点是能够将测试代码直接嵌入到源代码文件中，让测试与实现保持紧密联系，同时保持生产代码的纯净性。

核心特性

1. 零依赖、单头文件

Doctest 仅由一个头文件组成，无需复杂的构建配置或外部库依赖。

2. 极简的语法

测试用例的编写简单直观，学习曲线平缓。

3. 与 Catch2 高度兼容

如果你熟悉 Catch2，迁移到 Doctest 几乎无需修改代码。

4. 编译速度极快

相比其他测试框架，Doctest 的编译时间显著更短。

5. 丰富的断言宏

提供多种断言方式，满足不同测试场景需求。

快速入门示例

基本测试结构

text

// 引入 doctest 头文件
#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
#include "doctest.h"

// 被测试函数
int factorial(int number) {
    return number <= 1 ? 1 : factorial(number - 1) * number;
}

// 测试用例
TEST_CASE("测试阶乘函数") {
    CHECK(factorial(1) == 1);
    CHECK(factorial(2) == 2);
    CHECK(factorial(3) == 6);
    CHECK(factorial(10) == 3628800);
}

测试套件组织

text

#include "doctest.h"

// 测试套件：数学函数
TEST_SUITE("数学函数测试") {
    
    TEST_CASE("加法测试") {
        CHECK(1 + 1 == 2);
        CHECK(2 + 2 == 4);
    }
    
    TEST_CASE("减法测试") {
        CHECK(5 - 3 == 2);
        CHECK(10 - 7 == 3);
    }
}

高级断言功能

text

#include "doctest.h"
#include <vector>
#include <string>

TEST_CASE("各种断言示例") {
    std::vector<int> vec{1, 2, 3, 4, 5};
    std::string str = "hello";
    
    // 相等性检查
    REQUIRE(2 + 2 == 4);
    
    // 浮点数近似比较
    CHECK(1.0/3.0 == doctest::Approx(0.333333).epsilon(0.0001));
    
    // 异常检查
    CHECK_THROWS(throw std::runtime_error("error"));
    CHECK_THROWS_AS(throw std::runtime_error("error"), std::runtime_error);
    
    // 容器检查
    CHECK(vec.size() == 5);
    CHECK(vec[0] == 1);
    
    // 字符串检查
    CHECK(str == "hello");
}

测试夹具（Fixtures）

text

#include "doctest.h"

class DatabaseFixture {
public:
    DatabaseFixture() {
        // 测试前初始化
        db.connect("test_db");
    }
    
    ~DatabaseFixture() {
        // 测试后清理
        db.disconnect();
    }
    
    Database db;
};

TEST_CASE_FIXTURE(DatabaseFixture, "数据库查询测试") {
    auto result = db.query("SELECT * FROM users");
    CHECK(result.size() > 0);
    CHECK(result[0].name == "John");
}

参数化测试

text

#include "doctest.h"

int multiply(int a, int b) {
    return a * b;
}

TEST_CASE("参数化乘法测试") {
    SUBCASE("正数相乘") {
        CHECK(multiply(2, 3) == 6);
        CHECK(multiply(5, 4) == 20);
    }
    
    SUBCASE("负数相乘") {
        CHECK(multiply(-2, 3) == -6);
        CHECK(multiply(-2, -3) == 6);
    }
    
    SUBCASE("零值处理") {
        CHECK(multiply(0, 5) == 0);
        CHECK(multiply(7, 0) == 0);
    }
}

实际应用示例：字符串工具类测试

text

// string_utils.h
#pragma once
#include <string>
#include <vector>

class StringUtils {
public:
    static std::string trim(const std::string& str);
    static std::vector<std::string> split(const std::string& str, char delimiter);
    static bool startsWith(const std::string& str, const std::string& prefix);
};

// string_utils_test.cpp
#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
#include "doctest.h"
#include "string_utils.h"

TEST_SUITE("StringUtils 测试") {
    
    TEST_CASE("trim 函数测试") {
        CHECK(StringUtils::trim("  hello  ") == "hello");
        CHECK(StringUtils::trim("\t\nworld\r\n") == "world");
        CHECK(StringUtils::trim("no_spaces") == "no_spaces");
    }
    
    TEST_CASE("split 函数测试") {
        auto result = StringUtils::split("a,b,c,d", ',');
        REQUIRE(result.size() == 4);
        CHECK(result[0] == "a");
        CHECK(result[1] == "b");
        CHECK(result[2] == "c");
        CHECK(result[3] == "d");
    }
    
    TEST_CASE("startsWith 函数测试") {
        CHECK(StringUtils::startsWith("hello world", "hello") == true);
        CHECK(StringUtils::startsWith("hello world", "world") == false);
        CHECK(StringUtils::startsWith("test", "") == true);  // 空字符串总是匹配
    }
}

构建与运行

CMake 集成

text

cmake_minimum_required(VERSION 3.10)
project(MyProject)

# 添加 doctest
add_subdirectory(external/doctest)

add_executable(tests
    test_main.cpp
    string_utils_test.cpp
)

target_link_libraries(tests doctest)

命令行运行

text

# 编译测试
g++ -std=c++11 test_main.cpp -o tests

# 运行所有测试
./tests

# 运行特定测试套件
./tests "StringUtils 测试"

# 查看详细输出
./tests --success

优势对比

特性	Doctest	Google Test	Catch2
头文件大小	~20k 行	~50k 行	~40k 行
编译时间	最快	中等	较慢
依赖项	无	pthread	无
语法简洁性	优秀	良好	优秀
功能完整性	完整	完整	完整