用途:为 Simulink 工作流创建和管理 MATLAB 项目,协调 MATLAB 路径(Simulink 用它解析模型引用、数据字典和需求)、跟踪文件成员以纳入源代码控制,并通过标签实现 CI/CD 流水线中的目标选择自动化。
主要能力:创建新项目;向现有项目添加模型、数据字典或需求;配置项目路径以解析引用;设置标签用于自动化(测试选择、代码生成目标);配置源代码控制和缓存文件夹;诊断损坏的模型引用、缺失字典或项目健康检查失败。
使用方式:用 addPath(proj, folder) 将每个含字典、被引用模型、需求或配置文件的文件夹加入路径;向 addDataSource、set_param(...,'DataDictionary',...) 和 slreq.createLink 只传文件名而非完整路径;SimulinkCacheFolder 与 SimulinkCodeGenFolder 使用绝对路径;查询 proj.Dependencies 前先调用 updateDependencies(proj);创建或打开新项目前先关闭当前项目。修改后运行 runChecks(proj)、updateDependencies(proj) 并读取 proj.Dependencies 验证。
适用场景:新建 Simulink 模型项目、添加模型或需求、配置路径与标签、设置源代码控制与缓存、排查引用或健康检查问题。
限制:注册与路径是独立操作,通常两者都需要;addPath 不递归;同一时间只能打开一个项目;currentProject 在无项目打开时会报错;不要使用 proj.IgnoredFilePatterns、cat.Labels 或 'string' 标签类型;R2024a+ 标签查询用 findFiles(复数);启动脚本中不要用 clear all。构建模型、编写测试、起草需求或运行仿真应使用其他对应技能。