Simulink Test自动化（二）-基于脚本批量构建TestFile与TestSuite框架
1. 为什么需要批量构建TestFile与TestSuite
做Simulink模型测试的朋友都知道，当模型规模变大时，手动创建测试文件简直是一场噩梦。我去年负责一个汽车电控单元项目，模型包含200多个子系统，每个子系统都需要单独测试。如果手动操作，光是创建TestFile和TestSuite就得花上一整天，还容易出错。
脚本化批量创建的好处很明显：
- 效率提升：原来需要几小时的工作现在几秒完成
- 一致性保证：所有测试文件结构统一，避免人为差异
- 可维护性强：需求变更时只需修改脚本，不用逐个文件调整
举个实际例子，我们团队最近接手一个变速箱控制项目，模型包含15个功能模块，每个模块需要3种测试场景。手动创建需要45次重复操作，而用脚本只需要运行一次。
2. 准备工作与环境配置
2.1 基础环境检查
在开始写脚本前，确保你的环境已经就绪：
- MATLAB版本建议R2020b及以上
- 安装Simulink Test工具箱
- 准备好待测试的Simulink模型文件
可以用以下命令检查工具箱是否安装：
ver('sltest')2.2 模型结构分析
好的脚本从清晰的模型分析开始。我通常会先用这个命令获取模型结构：
load_system('your_model.slx'); blocks = find_system('your_model','SearchDepth',1); disp(blocks);建议先绘制模型架构图，明确：
- 需要测试的子系统列表
- 各子系统的输入输出接口
- 测试场景的分类方式
3. 核心脚本编写实战
3.1 创建TestFile的黄金法则
创建TestFile是整个框架的基础，这里有几个实用技巧：
% 清除已有测试文件 sltest.testmanager.clear; % 创建新TestFile testFile = sltest.testmanager.TestFile('MyTestFile.mldatx'); % 设置存储路径（重要！） testFile.FilePath = fullfile(pwd,'TestFiles');我强烈建议设置明确的文件存储路径，否则文件可能散落在各处。曾经有个项目因为没设路径，团队成员花了半天找测试文件。
3.2 配置覆盖率选项的陷阱
覆盖率设置看似简单，但有几个坑我踩过：
covSettings = getCoverageSettings(testFile); covSettings.RecordCoverage = true; covSettings.MdlRefCoverage = true; % 这些组合最实用 covSettings.MetricSettings = 'dmc'; % 决策+条件+MCDC covSettings.CoverageFiltering = 'on'; % 过滤库代码特别注意：MetricSettings参数大小写敏感，写成'DMC'会报错。建议先用getCoverageSettings检查当前配置。
4. 构建TestSuite的最佳实践
4.1 基础创建方法
TestSuite相当于测试分类，创建时要注意命名规范：
% 创建主TestSuite mainSuite = createTestSuite(testFile,'FunctionalTests'); % 创建子分类（三级结构更清晰） safetySuite = createTestSuite(testFile,'SafetyRequirements'); performanceSuite = createTestSuite(testFile,'PerformanceTests');我习惯用功能域作为分类标准，比如：
- SafetyRequirements
- FunctionalCorrectness
- BoundaryCases
4.2 处理默认TestSuite的坑
新建TestFile时会自动生成一个"New Test Suite 1"，建议删除：
defaultSuite = getTestSuiteByName(testFile,'New Test Suite 1'); if ~isempty(defaultSuite) remove(defaultSuite); end曾经因为这个默认Suite没删除，导致测试报告混乱，排查了好久。
5. 批量创建TestCase的技巧
5.1 基础创建模式
TestCase是真正的测试执行单元，一个经典创建模式：
harnessList = {'Harness1','Harness2','Harness3'}; % 假设已有harness列表 for i = 1:length(harnessList) tc = createTestCase(mainSuite,'baseline',harnessList{i}); setProperty(tc,'Model','your_model'); setProperty(tc,'HarnessOwner','your_model'); setProperty(tc,'HarnessName',harnessList{i}); end5.2 高级参数配置
更专业的做法是配置迭代参数：
testCases = {'Nominal','MinValue','MaxValue'}; for i = 1:length(testCases) tc = createTestCase(performanceSuite,'equivalence',testCases{i}); setProperty(tc,'Iterations',10); setProperty(tc,'StopOnError',false); end6. 实战中的常见问题排查
6.1 路径问题解决方案
我遇到最多的报错是"文件未找到"，解决方案：
% 确保路径正确 addpath(genpath('你的模型路径')); % 检查文件是否存在 if ~exist('your_model.slx','file') error('模型文件不存在！'); end6.2 句柄失效处理
当脚本运行时间较长时，可能出现句柄失效：
try testFile = sltest.testmanager.TestFile('MyTestFile.mldatx'); catch ME disp('句柄失效，重新创建...'); sltest.testmanager.clear; testFile = sltest.testmanager.TestFile('MyTestFile.mldatx'); end7. 完整脚本示例与解析
下面是我在一个真实项目中使用的脚本框架：
%% 初始化 clear; clc; modelName = 'EngineControlSystem'; testCategories = {'FuelInjection','Ignition','Emission'}; %% 创建TestFile sltest.testmanager.clear; tf = sltest.testmanager.TestFile([modelName '_Tests.mldatx']); tf.FilePath = fullfile(pwd,'TestArtifacts'); %% 配置覆盖率 cov = getCoverageSettings(tf); cov.MetricSettings = 'dmc'; cov.SaveCoverageData = true; %% 创建分类TestSuite for i = 1:length(testCategories) ts(i) = createTestSuite(tf,testCategories{i}); end %% 为每个分类添加TestCase harnessMap = containers.Map(... {'FuelInjection','Ignition','Emission'},... {{'FI_Nominal','FI_Fault'}, {'IGN_Test1','IGN_Test2'}, {'EMS_Validation'}}); for i = 1:length(testCategories) currentHarness = harnessMap(testCategories{i}); for j = 1:length(currentHarness) tc = createTestCase(ts(i),'baseline',currentHarness{j}); setProperty(tc,'Model',modelName); setProperty(tc,'HarnessName',currentHarness{j}); end end disp('测试框架构建完成！');这个脚本的特点是：
- 使用containers.Map管理测试用例映射
- 支持动态分类扩展
- 完整的错误预防机制
8. 进阶技巧与性能优化
8.1 并行创建加速
对于超大型模型，可以用parfor加速：
if license('test','Distrib_Computing_Toolbox') parfor i = 1:100 % 并行创建逻辑 end else % 串行版本 end8.2 自动化验证脚本
创建后建议运行验证脚本：
%% 验证TestFile结构 testFile = sltest.testmanager.load('MyTestFile.mldatx'); suites = getTestSuites(testFile); assert(~isempty(suites),'无TestSuite存在！'); %% 检查TestCase数量 totalCases = 0; for i = 1:length(suites) cases = getTestCases(suites(i)); totalCases = totalCases + length(cases); end fprintf('共创建%d个TestCase\n',totalCases);这套验证机制帮我在多个项目中发现早期问题，避免后续测试阶段返工。