C语言Unity库入门指南（手把手教你用Unity进行C语言单元测试）

第一步：获取Unity库

你可以从 GitHub 上克隆 Unity 仓库：

git clone https://github.com/ThrowTheSwitch/Unity.git

克隆后，你只需要关注以下三个核心文件（位于 src/ 目录）：

• unity.c
• unity.h
• unity_internals.h（通常不需要直接修改）

第二步：编写被测函数

假设我们要测试一个简单的加法函数。创建文件 math_utils.c 和 math_utils.h：

math_utils.h

#ifndef MATH_UTILS_H#define MATH_UTILS_Hint add(int a, int b);#endif // MATH_UTILS_H

math_utils.c

#include "math_utils.h"int add(int a, int b) {    return a + b;}

第三步：编写测试用例

创建测试文件 test_math_utils.c：

#include "unity.h"#include "math_utils.h"void setUp(void) {}void tearDown(void) {}void test_add_two_positive_numbers(void) {    TEST_ASSERT_EQUAL(5, add(2, 3));}void test_add_positive_and_negative(void) {    TEST_ASSERT_EQUAL(-1, add(2, -3));}int main(void) {    UNITY_BEGIN();    RUN_TEST(test_add_two_positive_numbers);    RUN_TEST(test_add_positive_and_negative);    return UNITY_END();}

说明：

• setUp() 和 tearDown() 是每个测试前后可选的初始化/清理函数（此处留空）。
• TEST_ASSERT_EQUAL(expected, actual) 是 Unity 提供的断言宏。
• RUN_TEST() 用于注册并运行测试函数。

第四步：编译并运行测试

将所有源文件一起编译：

gcc -o test_runner \    unity/src/unity.c \    math_utils.c \    test_math_utils.c./test_runner

如果一切正常，你将看到类似以下输出：

..-----------------------2 Tests 0 Failures 0 IgnoredOK

为什么选择Unity？

对于 嵌入式C测试 场景，Unity 具有以下优势：

• 极小的内存占用（仅需几百字节 RAM）
• 无需操作系统或动态内存分配
• 支持自定义输出（可重定向到串口）
• 丰富的断言宏（如 TEST_ASSERT_TRUE, TEST_ASSERT_FLOAT_WITHIN 等）

总结

通过本教程，你已经掌握了如何使用 C语言Unity库 进行基本的单元测试。无论你是开发桌面应用还是资源受限的嵌入式设备，Unity单元测试 都能帮助你写出更可靠、更易维护的 C 代码。建议将测试集成到你的构建流程中，实现持续验证。

现在就去试试吧！让 C语言测试框架 成为你开发路上的得力助手。