SuperAPI AI 工具集

matlab-configure-toml-project

通用与其它

查看项目

更新于 10-16 06:45

技能介绍

用途:在 MATLAB 语境下处理 matlab.toml 项目配置文件,包括新建、编辑、组织与配置。matlab.toml 是 TOML 格式的项目定义文件,须放在项目根目录(与 .git/ 同级)。R2026b 及以后新项目优先使用 matlab.toml;已有 .prj 项目仍受支持,可用 matlab.project.convertDefinitionFiles(pwd, "Toml") 双向转换。

主要能力:定义 [folders] 的 path 与 test 路径、[dependencies] 的 MATLAB 包或引用项目、[project] 的生命周期脚本与元数据、[project.shortcuts] 快捷方式、标签与导出配置、[[package]] 打包元数据、[compiler.*] 部署目标、[matlab.test] 测试配置及 [simulink] 设置。除 [user] 外所有表为封闭表,不接受未知键。

使用方式:新建时先询问项目名(唯一必填字段),扫描现有 .m/.mlx/.slx/.mlapp 子文件夹、测试目录与 startup/shutdown 脚本,生成最小草稿再逐步补充可选段。编辑时先读取现有文件,只改动用户要求的段,保留注释与顺序,并逐键对照格式参考校验。openProject、buildtool、runtests 会激活配置,路径由 [folders].path 控制,不应在源码中散布 addpath。

限制:openProject 不校验 schema,未知键、缺失文件与错误类型会静默加载,成功打开不代表文件正确。路径值须实际确认存在,不能猜测。MathWorks 产品不得写入 [dependencies]。不要用 matlab.project.createProject 反向生成文件,也不要将 .prj 的键带入 matlab.toml。深度部署目标细节需直接查阅部署参考文档。