Simulink单元测试实战：从Test Harness搭建到Test Manager完整流程（Matlab2018a版）

Simulink单元测试实战：从Test Harness搭建到Test Manager完整流程（Matlab2018a版）

对于许多刚接触Simulink模型开发的工程师来说，如何系统性地验证一个模块或子系统的功能正确性，常常是一个令人头疼的问题。我们习惯于在模型画布上拖拽连线、设置参数，然后点击那个绿色的“运行”按钮，观察Scope里波形是否“看起来”正常。然而，在工业级开发，尤其是汽车电子、航空航天等对安全性和可靠性要求极高的领域，这种依赖人工观察的“感觉式”验证是远远不够的。单元测试，作为软件工程中的基石实践，在基于模型的设计（MBD）中同样扮演着至关重要的角色。它要求我们将模型视为代码，用一套自动化、可重复、标准化的流程去检验其每一个行为是否符合预期。

Simulink环境为我们提供了强大的内置测试工具链，核心便是Test Harness（测试框架）和Test Manager（测试管理器）。但官方文档往往侧重于功能罗列，而实际工程中，从零搭建环境到成功运行测试，中间会遇到各种“坑”，比如输入输出信号如何精准对应、Excel测试用例模板的诡异格式、测试结果为何与仿真不一致等。本文将以Matlab 2018a为操作环境，抛开理论，直击实战，通过一个完整的Step-by-Step案例，带你打通从创建测试环境到执行自动化测试的任督二脉。无论你是需要应对ASPICE或ISO 26262等标准中对于测试可追溯性的要求，还是单纯想提升模型质量与开发效率，这套流程都将为你提供一个坚实可靠的起点。

1. 理解核心概念：为什么需要Test Harness与Test Manager？

在深入操作之前，我们有必要厘清两个核心工具的角色与关系。很多初学者会混淆它们，导致在配置时思路混乱。

Test Harness，中文常译为“测试框架”或“测试线束”。你可以把它想象成一个专门为被测模型定制的“测试工作台”。当我们想测试一个单独的发动机控制模块（ECU软件模型）时，不会直接把整个汽车装上去跑，而是把它放在一个实验台上，接上我们可控的模拟信号输入（如油门踏板信号、转速信号），并连接测量仪器来捕获它的输出（如喷油量、点火角）。这个实验台就是Harness。在Simulink中，创建Test Harness意味着系统会自动生成一个新的、独立的模型文件（或嵌入在原模型中），这个模型里包含了被测系统（System Under Test, SUT），并为其自动配置好了输入信号源和输出信号接收器。它的核心价值在于隔离：将被测对象从其复杂的上下文中剥离出来，提供一个纯净、可控的测试环境。

Test Manager，则是整个测试活动的“指挥中心”和“报告生成器”。如果说Test Harness是单个实验台，那么Test Manager就是管理着数十上百个实验台的实验室主任。它允许你：

• 组织测试用例：将针对同一模型或不同模型的多个测试用例（Test Case）分类归档到测试套件（Test Suite）中。
• 定义测试输入与预期输出：以结构化的方式（如通过Excel表格）为每个测试用例指定输入信号序列和期望的输出结果（Baseline）。
• 配置仿真参数：可以针对测试覆盖原模型的仿真配置，例如修改仿真时长、求解器类型等。
• 执行与自动化：批量运行选定的测试用例，并自动比较仿真结果与预期结果。
• 生成详细报告：提供图形化、数据化的测试结果，包括通过/失败状态、信号对比图、覆盖度统计等。

它们的关系是：Test Harness提供了测试执行的“战场环境”，而Test Manager则制定了在战场上作战的“具体方案”（测试用例）并评估“战果”（测试结果）。通常，一个Test Harness可以被多个不同的Test Case所引用，用于验证模型在不同输入条件下的行为。

注意：虽然Matlab后续版本（如2020b以后）的Simulink Test功能有增强和界面调整，但2018a版本的核心逻辑与工作流已经非常成熟和完整。掌握此版本的操作，对于理解更高级版本或应对企业内可能存在的旧版本环境都大有裨益。

2. 第一步：创建你的第一个Test Harness

让我们从一个简单的模型开始。假设我们有一个车速控制器模型 SpeedController.slx，它根据目标车速和实际车速的差值，计算出一个油门控制量。我们的任务是验证这个控制器的基本功能。

2.1 创建Harness的两种途径

方法一：直接为模型创建（推荐） 这是最快捷的方式，适用于测试整个顶层模型或当你尚未确定具体测试细节时。

1. 在 SpeedController.slx 模型的画布空白处，单击鼠标右键。
2. 在弹出的菜单中，选择 Test Harness -> Create for Model...。
3. 随后会弹出“Create Test Harness”配置对话框。

方法二：为子系统创建 如果你的模型很复杂，需要针对内部某个特定子系统（如PID控制器子模块）进行单元测试，可以使用此方法。

1. 在模型中找到并选中你想要测试的子系统模块。