C / C++ / 系统课时
写一个最小的测试程序
写一个最小的测试程序
C 项目不必先引入复杂测试框架才能开始自动化测试。本节把一个独立模块和测试程序分开编译,使用标准库 assert 检查正常输入与边界输入,并通过进程结果验证测试是否通过。
学习目标
- 能为一个独立 C 模块编写最小测试可执行程序
- 能使用
assert检查正常输入和边界输入 - 能编译、运行测试并识别断言失败的含义
准备被测试的独立模块
假设项目有一个分数规范化函数:小于 0 的值变为 0,大于 100 的值变为 100,其余值保持不变。生产代码与测试代码分开,可以让测试程序直接调用公开接口,而不必复制实现。
片段示例:score.h 只声明模块接口,需要与下面的 score.c 和测试文件放在同一目录。
#ifndef SCORE_H
#define SCORE_H
int clamp_score(int score);
#endif片段示例:score.c 实现上面的接口,需要通过编译命令与测试程序一起构建。
#include "score.h"
int clamp_score(int score) {
if (score < 0) {
return 0;
}
if (score > 100) {
return 100;
}
return score;
}这两个文件本身不负责输出结果。验证方法是把它们与测试程序一起编译,并观察测试进程是否正常结束。
编写测试可执行程序
测试程序只负责准备输入、调用被测函数并检查结果。把不同意图拆成小测试函数,比把所有断言堆在 main 中更容易发现遗漏,也方便以后继续添加用例。
以下 test_score.c 是完整测试程序,依赖同目录中的 score.h 和 score.c。
#include <assert.h>
#include <stdio.h>
#include "score.h"
static void test_normal_input(void) {
// 正常范围内的值不应被修改。
assert(clamp_score(75) == 75);
assert(clamp_score(0) == 0);
assert(clamp_score(100) == 100);
}
static void test_out_of_range_input(void) {
// 检查刚越过边界以及明显越界的输入。
assert(clamp_score(-1) == 0);
assert(clamp_score(101) == 100);
assert(clamp_score(500) == 100);
}
int main(void) {
test_normal_input();
test_out_of_range_input();
puts("all tests passed");
return 0;
}预期输出
all tests passed如果任意表达式为假,assert 会终止程序;具体诊断文本由所使用的 C 标准库实现决定,因此测试脚本应主要依赖非零退出状态,而不是匹配某一段固定错误文字。
编译并运行测试
在三个文件所在目录执行下面的命令。-Wall 和 -Wextra 同时打开常用编译警告,避免测试程序本身带着明显问题运行。
cc -std=c11 -Wall -Wextra -pedantic score.c test_score.c -o test_score && ./test_score预期输出
all tests passed如果编译成功但某个断言失败,&& 后启动的测试程序会以失败状态结束。此时应先查看失败断言对应的输入和预期值,再判断问题来自生产实现还是测试期望。
边界用例要紧贴规则
“正常输入”只证明常见路径可以工作,真正容易暴露错误的是边界。这里除了测试 75,还显式检查了 0、100、-1 和 101。它们分别覆盖有效区间两端以及刚越过两端的位置,能够发现 <、<=、>、>= 写错造成的典型缺陷。
新增规则时也应同步新增测试。例如接口以后规定 60 分以下统一返回 0,就应该先把 59、60 等临界输入加入测试,而不是只继续增加 20、30 这类相似普通值。
不要在测试构建中关闭 assert
标准 C 在定义 NDEBUG 后会关闭 assert。如果测试目标依赖断言,就不要使用 -DNDEBUG 编译测试可执行程序,否则这些检查会被移除,程序可能在没有执行任何断言的情况下打印成功信息。
这种最小测试方式适合小型 C 模块和项目起步阶段。随着测试数量增加,可以再把这些测试可执行程序接入 CMake 和 CTest;无论以后使用什么框架,核心仍然是让每个测试准备明确输入、检查可观察结果,并在失败时返回可被自动化工具识别的状态。