1. MATLAB环境配置与工程算法脚本模板搭建

环境配置与脚本模板搭建

工程算法开发中，环境不统一会导致脚本在不同机器上出现路径失效、函数重名、工具箱缺失等问题。本例通过配置 MATLAB 搜索路径、清理工作区、检测工具箱，并建立一个三段式脚本模板（参数区 / 主计算区 / 结果输出区），使算法脚本具备可复用、可移植的基础结构。

路径与工作区配置

MATLAB 的搜索顺序为：当前文件夹 → 搜索路径中的文件夹。工程中应把项目根目录及其子目录加入路径，避免使用 cd 频繁切换。推荐用 addpath 配合 genpath 一次性加入项目目录树，并用 savepath 持久化（可选）。

% 环境初始化：路径 + 工作区
clear; close all; clc;              % 清理变量、图窗、命令行
projRoot = 'D:\AlgoProj';           % 项目根目录（按实际修改）
addpath(genpath(projRoot));         % 递归加入所有子目录
assert(exist('AlgoProj','dir')==7 || isfolder(projRoot), '项目目录不存在');

% 工具箱可用性检测
needToolbox = {'Signal Processing Toolbox','Optimization Toolbox'};
v = ver;
installed = {v.Name};
for k = 1:numel(needToolbox)
    ok = any(strcmp(installed, needToolbox{k}));
    fprintf('%-28s : %s\n', needToolbox{k}, string(ok));
end

可复用脚本模板结构

模板把脚本划分为三个职责明确的区域：参数区集中所有可调输入，主计算区只做算法逻辑，结果输出区负责保存与展示。这样修改参数不影响算法，替换算法不影响输出格式。

%% ========== 1. 参数区 ==========
cfg.fs        = 1000;        % 采样率 Hz
cfg.f0        = 50;          % 信号频率 Hz
cfg.duration  = 2;           % 时长 s
cfg.outDir    = fullfile(projRoot,'results');
if ~exist(cfg.outDir,'dir'); mkdir(cfg.outDir); end

%% ========== 2. 主计算区 ==========
t = 0:1/cfg.fs:cfg.duration-1/cfg.fs;
x = sin(2*pi*cfg.f0*t);
y = x + 0.1*randn(size(x));   % 示例：加噪信号

%% ========== 3. 结果输出区 ==========
fig = figure('Visible','off');
plot(t,y); xlabel('t/s'); ylabel('幅值'); title('加噪正弦信号');
saveas(fig, fullfile(cfg.outDir,'signal.png'));
save(fullfile(cfg.outDir,'result.mat'),'cfg','x','y');
fprintf('结果已保存至 %s\n', cfg.outDir);

模板运行与验证

把上述模板保存为 algo_template.m，在命令行执行 algo_template。验证要点：

• 命令行无 Undefined function 或路径警告；
• results 目录下生成 signal.png 与 result.mat；
• 修改 cfg.f0 后重跑，输出图像频率随之变化，说明参数区生效。

常见问题排查