用途 本技能用于 MATLAB R2026a 和 GNU Octave 数值代码的设计、审查与版本迁移,也覆盖可复现项目准备和执行规划。资料强调 MATLAB 与 GNU Octave 是两个不同产品,兼容性只是部分的,不构成许可或行为保证。
产品与许可边界 MATLAB R2026a 为专有软件,不得假定 MATLAB、MATLAB Online、任命名工具箱、MATLAB Test、MATLAB Compiler、MATLAB Coder、Parallel Computing Toolbox 或任何附加组件已安装、已授权或可用。MATLAB Runtime 不是 MATLAB,只能运行由 MATLAB Compiler 生成的应用,不能运行任意源码,也不能作为 Python 的 MATLAB Engine 宿主。构建产物需要相应已授权编译器及源码用到的全部产品。GNU Octave 11.3.0 为 GPLv3+ 免费软件,其包不等于 MATLAB 工具箱,名称相似不代表 API、数值、图形或许可等价。使用前应询问用户实际的运行时、版本、平台、已安装产品和许可情况。
安全边界 不得运行不可信的 .m、.mlx、MEX 二进制、MAT 文件、项目启动/关闭动作、包安装器或生成产物;静态审查不能证明安全。执行或代码加载面包括 eval、evalin、assignin、文本派生 feval、str2func、回调、定时器、应用回调、动态修改的路径,以及 system、unix、dos、shell 转义 !、Java、.NET、Python(py.*、pyrun、pyrunfile)、MEX 和本机库;mex、codegen、MATLAB Compiler、构建任务、包/项目启动和生成代码亦然;还包括 load、对象反序列化(loadobj、自定义序列化)、函数句柄、Java/System 对象以及 MAT 文件可达的类代码。.mlx 对工具包而言是不透明归档,MEX 是本机可执行代码;不要用 Python pickle 交换数据。应先检查、必要时隔离、取得明确批准后,再由用户确认的可执行程序与许可来调用。
默认工作流
- 明确目标:记录 MATLAB 版本或 Octave 版本、操作系统/架构、基础产品与所需工具箱/包、预期输入输出、数值容差,以及是否授权执行。
- 静态清点:在运行时加载前扫描 .m 文件、不透明产物、项目路径、所需产品和 MAT 文件头。
- 选择代码形式:自动化优先用带 arguments 块的函数;脚本仅用于受控编排,实时脚本用于经审查的交互叙述。
- 明确语义:记录形状、类别、单位、缺失值规则、索引、隐式扩展、随机数算法/种子、容差和输出格式。
- 无隐藏状态测试:测试数据保持合成、路径项目本地、图形确定性,测试不依赖基础工作区残留。
- 规划执行:生成 argv 计划,审查启动/路径影响与许可,仅在明确批准后于这些辅助工具之外启动。
- 记录溯源:对命名输入/代码做哈希,记录版本、产品、随机策略、容差和命令计划,不转储整个环境。
语言与数据要点 脚本共享调用方/基础工作区并留下变量;函数有本地工作区和显式输入输出。实时脚本 .mlx 混合代码与富输出,但不是纯文本审查产物,应导出为 .m 再静态检查。避免 clear all、宽泛 addpath(genpath(...))、依赖 pwd、全局变量和静默名称遮蔽;使用项目根与 fullfile。arguments 块中应校验尺寸、类别与取值,注意类型声明可转换输入而验证器只检查不转换。MATLAB 使用 1 基、列主序索引;A(i,j)、A(k)、A(:,j)、A{...} 与 A.(name) 语义不同。*、/、\、^ 为矩阵运算,带点形式为逐元素;用 A\b 而非 inv(A)*b。自 R2016b 起兼容维度可隐式扩展,易产生外积的运算前应断言预期形状。浮点结果应使用按领域选定的绝对/相对容差比较。随机需固定算法和种子,并行独立工作使用命名 RandStream 子流,不用基于时间的 rng("shuffle") 声称可复现。
表格与缺失值 table 具有等高的命名变量且类型可不同;T(rows,vars) 返回表,T{rows,vars} 取出内容,T.Var 选单个变量。timetable 额外有行时间,应先排序并校验时区与唯一性,再有意识地使用 retime/synchronize。缺失哨兵依类型而异:NaN、NaT、<missing>、<undefined> 和空字符向量;整数与逻辑数组没有标准缺失哨兵。生产数据应定义导入选项而非依赖推断。
图形与文件交换 使用显式 figure/axes 句柄与 tiledlayout,标注单位,明确设置范围、色标、字号与颜色图;出版输出优先 exportgraphics 而非 saveas。R2026a 中它可导出栅格、PDF/EPS/EMF、SVG、GIF 和交互式 HTML,格式能力不同;适合 PDF/SVG 风格输出时指定 ContentType="vector",栅格输出指定 Resolution。MAT 文件版本 7 是常规 save 默认值,matfile 默认创建 7.3;版本 4/6/7/7.3 在类型、压缩和单变量限制上不同。7.3 基于 HDF5,但不是任意 HDF5 交换契约。绝不加载不可信 MAT 文件,先清点头部/数据集;对象可能触发类反序列化行为。简单交换优先使用有文档化 schema 的 CSV/JSON/Parquet/HDF5,不得把 pickle 载荷改名为 MAT 文件。
项目、分析与测试 使用 MATLAB Projects 控制路径、启动/关闭任务、依赖、源码控制和可复现入口;打开不可信项目前审查项目动作。matlab.codetools.requiredFilesAndProducts 与 Dependency Analyzer 是静态近似,动态分派可能漏报或误报,所需产品报告不能证明许可可用。迁移前使用 Code Analyzer(codeIssues;旧文本流程可用 checkcode)和 codeCompatibilityReport。基础 MATLAB 含脚本、函数和类形式的 matlab.unittest 工作流;并行运行需要 Parallel Computing Toolbox;依赖选择、更丰富质量看板、生成测试和高级覆盖率/等价特性可能需要 MATLAB Test 等产品。R2026a 的 runtests 在目标测试属于未打开项目时会自动打开项目并在之后关闭,使用前应考虑启动与关闭动作。
Python 集成(R2026a) R2026a 对 MATLAB Interface to Python、MATLAB Engine for Python 和 MATLAB Compiler SDK for Python 支持 64 位 CPython 3.9–3.13。当前审阅的 R2026a PyPI 包为 matlabengine==26.1.12(2026-05-08 发布),要求已安装 R2026a,仅有 MATLAB Runtime 不够;R2026a 也在一个命名 matlabroot 路径下预装 Engine 发行版。安装包不授予 MATLAB 或工具箱许可。应配置一个命名解释器/可执行文件,不打印完整环境、PATH、PYTHONPATH 或凭据。pyenv 控制 MATLAB 到 Python 的解释器选择;进程内 Python 切换通常需重启 MATLAB,进程外 Python 可终止并重配。matlab.engine.start_matlab() 是显式执行动作,会启动 MATLAB 进程并可能签出许可,不能仅为探测可用性而调用。应验证 NumPy 数组、pandas DataFrame、table/timetable、字符串/缺失值、datetime/duration、字典、形状/顺序以及不支持的稀疏/对象/分类情形的转换语义。
本地辅助命令行工具 所有辅助工具不联网、有边界、拒绝符号链接且不执行代码,使用 Python 3.11+ 在技能目录运行;Bash 仅用于调用这些 Python 命令行和验证命令,不得用于执行生成的 MATLAB/Octave argv 计划或不可信产物。scripts/plan_batch_command.py 生成经审查的 MATLAB/Octave argv 但不执行;scripts/scan_m_code.py 扫描 .m 文本并标记不透明 .mlx/MEX 风险;scripts/validate_project_manifest.py 校验路径及声明的产品/许可状态;scripts/inventory_mat_file.py 做头部/元数据清点且不调用 loadmat;scripts/plan_python_compatibility.py 检查 R2026a CPython/Engine 兼容性;scripts/reproducibility_report.py 对命名本地产物做哈希并输出有界报告;scripts/generate_function_scaffold.py 干跑或创建函数与单元测试脚手架,默认干跑,写入需 --write 且拒绝冲突。SciPy 与 h5py 为可选清点后端,若获授权应将确切的已审阅版本加入调用方项目锁文件。
适用场景与限制 适用于 MATLAB/Octave 数值代码设计审查、版本迁移、可复现项目准备、执行规划、安全静态检查和 Python 互操作核查。限制在于:不假定任何产品、工具箱或许可可用;不执行不可信代码或产物;MATLAB 与 Octave 仅部分兼容;辅助工具本身不启动 MATLAB、Octave、Python Engine、编译器或子进程;缺失的收费、平台细节等事实以资料为准,资料未提供的一律暂未提供。