第一个脚本怎么写：新建 .m 文件、F5 运行、保存到当前文件夹的完整流程

一、为什么"第一个脚本"值得认真对待

几乎每一本 MATLAB 入门书都会在第一章告诉你：点击"新建脚本"，输入 disp('Hello World')，按 F5，看到命令行窗口输出。然后呢？然后就没有然后了。读者以为自己学会了"写脚本"，实际上只是学会了"按一个键"。

笔者认为，这种教学路径存在一个结构性缺陷：它把"脚本"当作一个孤立的文件操作来教，而没有把脚本放回 MATLAB 的执行上下文中去理解。脚本的本质不是"一个文件"，而是"一段在特定上下文中被解释执行的指令序列"。这个上下文至少包含三个要素：文件所在的位置（当前文件夹或搜索路径）、MATLAB 工作区的当前状态（变量、断点、路径缓存）、以及调用方式（F5、命令行输入文件名、还是被其他脚本调用）。

本文评述：把这三个要素称为"执行上下文三要素"，并非为了造概念，而是因为它们直接对应了初学者最常遇到的四类问题——"文件找不到"（路径问题）、"变量莫名其妙被覆盖"（工作区问题）、"改了代码但运行结果没变"（缓存问题）、"脚本能跑但函数报错"（调用方式问题）。理解了这三要素，F5 就不再是一个"魔法按键"，而是一个可解释、可预测、可调试的操作。

从工程实践的角度看，第一个脚本还承担着一个隐性任务：建立命名习惯与目录习惯。MathWorks 官方文档在 MATLAB Programming Fundamentals（R2024a）中明确指出，脚本文件名必须以字母开头，只能包含字母、数字和下划线，且不得超过 namelengthmax 返回的字符数（通常为 63）。这些规则不是"建议"，而是硬约束——违反它们，脚本可能能保存，但无法被正确调用。

拓展阅读：MathWorks 官方"创建脚本"教程页 mathworks.com/help/matlab/learn_matlab/scripts.html；MATLAB 官方 YouTube 频道的 "Getting Started with MATLAB" 系列视频亦值得一看。

二、MATLAB 执行模型：脚本、函数与命令行的三角关系

2.1 三种代码载体的语义差异

在 MATLAB 中，用户写的代码可以存在于三个地方：命令行窗口（Command Window）直接输入的语句、脚本文件（script）、函数文件（function）。这三者的执行语义有本质区别，而初学者往往把它们混为一谈。

载体	工作区	输入输出	典型用途
命令行	Base 工作区	无	快速验证、临时计算
脚本 .m	Base 工作区	无（可用 input 交互）	流程编排、数据处理流水线
函数 .m	函数自己的工作区	有明确输入输出	可复用模块、算法封装

这张表最关键的一行是"工作区"。脚本在 Base 工作区中执行，意味着脚本里创建的每一个变量都会"泄漏"到命令行中，并且脚本可以读写命令行中已有的变量。函数则拥有独立的函数工作区，外部变量不可见（除非通过输入参数传入）。脚本的"共享工作区"特性既是它最大的便利，也是它最大的隐患。

本文评述：很多教程把脚本描述为"没有输入输出的函数"，这个说法在语法层面没错，但在语义层面具有误导性。脚本不是"缺了参数的函数"，而是"批处理化的命令行"。它的设计初衷就是让用户把在命令行里反复敲的一串命令固化下来，因此它天然继承命令行的所有特性——包括变量污染和状态依赖。理解这一点，才能理解为什么 MathWorks 在 R2016b 之后大力推广 local functions（脚本内局部函数），以及为什么大型项目最终都要走向函数化。

2.2 脚本的执行栈：从 F5 到结果输出

当你在编辑器中按下 F5，MATLAB 并非"直接运行文件内容"，而是经历了一个可分解的流程。根据 MathWorks 官方文档 Run MATLAB Scripts（R2024a）的描述，以及笔者在 R2021b–R2024a 多个版本上的实测，这个流程可以概括为以下步骤：

1. 保存检查：若文件有未保存修改，编辑器会先触发保存（取决于"保存时运行"设置，默认开启）。
2. 路径解析：MATLAB 在当前文件夹和搜索路径中查找该脚本名对应的文件，确定要执行的是哪一个。
3. 语法检查：M-Lint（现称 Code Analyzer）对文件做静态分析，若存在语法错误则中止并报错。
4. 上下文准备：脚本在 Base 工作区中执行，若工作区已有同名变量，脚本中的赋值会覆盖它们。
5. 逐行解释执行：MATLAB 解释器逐行执行语句，JIT 加速对循环等热点代码生效。
6. 结果输出：未加分号的语句将结果打印到命令行窗口，已加分号的静默执行。

这六步中，第 2 步和第 4 步是最容易被忽视、也最容易出问题的环节。第 2 步涉及"当前文件夹"与"搜索路径"的优先级，将在第四章详述；第 4 步涉及工作区状态，是脚本调试中最常见的困惑来源。

2.3 脚本与实时脚本（Live Script）的关系

自 R2016a 引入 Live Script（.mlx 文件）以来，MATLAB 的"脚本"概念出现了分化：传统 .m 脚本是纯文本、可版本控制、可在任意编辑器打开；Live Script 是富文本格式（本质是 OPC 包，类似 .docx），支持内嵌输出、交互控件和格式化文本。两者在功能上有重叠，但定位不同。

MathWorks 在 R2023b 的发布说明中强调，Live Script 适合教学、报告和探索性分析，而 .m 脚本适合工程化、自动化流水线。本文评述：对于"第一个脚本"，笔者建议从 .m 文件入手。原因有三：其一，.m 是纯文本，便于理解"代码就是文本"这一基本事实；其二，.m 文件的版本控制友好，Git diff 可读；其三，大量第三方工具箱和开源项目仍以 .m 为主，掌握 .m 是阅读他人代码的前提。Live Script 可以作为第二阶段的学习目标。

三、新建 .m 文件：从编辑器入口到命名规范

3.1 三种新建入口的差异

在 MATLAB 桌面环境中，新建 .m 文件至少有三种方式，它们的默认行为并不完全相同：

入口	操作路径	默认文件名	默认保存位置
主页选项卡	Home → New Script	Untitled.m	未保存（内存中）
编辑器内	Editor → New → Script	Untitled2.m	未保存
当前文件夹	右键 → New → Script	Untitled.m	当前文件夹

第三种方式最值得推荐，因为它从一开始就把"文件位置"这个上下文要素纳入进来。前两种方式创建的脚本处于"未保存"状态，此时按 F5 会弹出保存对话框，反而多了一步。从当前文件夹右键新建，等于在创建文件的同时就确定了它的执行上下文。

3.2 命名规范：不只是"别用中文"

关于 MATLAB 文件命名，流传最广的建议是"不要用中文名"。这个建议方向正确，但理由常常被误传。真正的原因不是"MATLAB 不支持中文"，而是：脚本名会成为函数名，而函数名必须是合法的 MATLAB 标识符。根据官方文档 Variable Names 与 Scripts vs. Functions，合法标识符的规则是：以字母开头，后接字母、数字或下划线，长度不超过 namelengthmax。

本文评述：中文文件名在部分操作系统和 MATLAB 版本上确实可以保存和运行，但会带来三类风险——跨平台传输时的编码问题、命令行调用时的输入法问题、以及与第三方工具（如 Git、CI 系统）集成时的兼容问题。因此，"用英文命名"不是 MATLAB 的硬性要求，而是工程协作的软性约定。对于个人学习脚本，中文名未必报错；但对于任何可能被分享、被版本控制、被自动化调用的脚本，英文命名是更稳妥的选择。

另一个常被忽视的规则是：脚本名不应与 MATLAB 内置函数或工具箱函数同名。例如，把脚本命名为 sum.m、plot.m、mean.m，会导致内置函数被"遮蔽"（shadowing）。MATLAB 会优先执行当前文件夹中的同名文件，从而引发难以排查的错误。检测方法是使用 which -all sum 查看是否存在多个同名文件。

3.3 编辑器初始内容与模板

新建的 .m 文件默认是空白的。对于第一个脚本，建议直接写入以下内容作为起点：

% my_first_script.m
% 第一个 MATLAB 脚本示例
% 创建日期：2024-XX-XX
% 说明：演示基本输出与变量操作

clc;        % 清空命令行窗口
clear;      % 清空工作区变量
close all;  % 关闭所有图形窗口

x = 1:10;
y = x.^2;
disp('x 的平方为：');
disp(y);

这段模板包含三个工程习惯：文件头注释（说明用途与日期）、环境清理（clc/clear/close all）、以及可验证的输出。本文评述：clear 在脚本开头是否必要，社区存在争议。支持者认为它保证脚本从干净状态开始；反对者指出它会清空用户工作区中可能需要的变量。笔者的建议是：在学习阶段保留 clear，在工程脚本中谨慎使用，或改用 clearvars -except 保留关键变量。

四、当前文件夹：MATLAB 路径解析的第一优先级

4.1 搜索路径的优先级顺序

MATLAB 查找一个名字（脚本名、函数名、变量名）时，遵循一套明确的优先级规则。根据官方文档 What Is the MATLAB Search Path?（R2024a），从高到低依次为：

1. 变量：若工作区中存在同名变量，优先作为变量解析。
2. 当前文件夹中的文件：即 Current Folder 中的 .m、.mlx、.mat 等。
3. 搜索路径中的文件：按路径顺序（path 列表从上到下）查找。
4. 内置函数与工具箱：MATLAB 自带的函数。

这个顺序解释了一个经典困惑：为什么"我把脚本放在桌面，双击能打开，但 F5 报错说找不到函数"？因为双击打开只是"打开文件"，而 F5 运行需要"解析名字"，后者依赖搜索路径。如果桌面不在搜索路径中，脚本中的函数调用就可能失败。

本文评述：当前文件夹之所以被赋予如此高的优先级，是因为它代表了"用户当前的工作现场"。MATLAB 的设计哲学是"交互式优先"——用户在哪里工作，哪里就应该被优先搜索。这与 Python 的 sys.path 机制、以及 Node.js 的 node_modules 解析有相似之处，但 MATLAB 把"当前文件夹"提升到了比"已安装路径"更高的位置，这在工程上是一把双刃剑：方便，但容易造成"本地文件遮蔽系统函数"的事故。

4.2 如何确认与切换当前文件夹

确认当前文件夹有三种方式：

• 界面：工具栏下方的地址栏显示当前文件夹路径。
• 命令：pwd 返回当前文件夹的绝对路径。
• 函数：cd 不带参数时显示当前路径。

切换当前文件夹同样有多种方式：界面地址栏直接输入路径、命令行使用 cd('路径')、或使用 uigetdir 弹出对话框选择。对于第一个脚本，最直接的方式是：在 MATLAB 界面左侧的"当前文件夹"面板中，导航到目标目录，然后右键新建脚本。

4.3 路径缓存与刷新

MATLAB 会缓存搜索路径以加速查找。当你在外部（如文件资源管理器）新增、删除或重命名 .m 文件后，MATLAB 可能不会立即感知。此时需要刷新路径缓存：

rehash;          % 刷新函数/文件缓存
rehash path;     % 刷新搜索路径缓存
rehash toolboxcache;  % 刷新工具箱缓存（较慢）

本文评述：路径缓存问题是"改了代码但运行结果没变"的常见原因之一，另一个原因是编辑器未保存。排查顺序建议为：先确认文件已保存（标题栏无星号），再 rehash，最后 clear all。这三步能解决绝大多数"代码不生效"的问题。

五、F5 运行：一次按键背后发生了什么

5.1 F5 的默认行为与可配置项

F5 是 MATLAB 编辑器中"运行"的默认快捷键。它的行为受多个设置影响，可在 Home → Preferences → Editor/Debugger 中调整：

设置项	默认值	影响
Save changes before running	开启	F5 前自动保存
Run in Command Window	开启	在 Base 工作区执行
Clear workspace before run	关闭	是否先清空变量

"Clear workspace before run"这一项值得特别说明。若开启，每次 F5 前工作区被清空，脚本从零状态开始；若关闭（默认），工作区保留上次运行的变量。本文评述：默认关闭是合理的，因为它支持"增量调试"——你可以先运行脚本前半段，检查中间变量，再继续运行。但它也带来风险：脚本可能依赖上次运行遗留的变量，导致"单独运行报错、连续运行正常"的诡异现象。工程脚本应在开头显式 clear，消除这种隐式依赖。

5.2 运行时的错误处理

F5 运行出错时，MATLAB 会在命令行窗口输出红色错误信息，并在编辑器中高亮出错行。错误信息通常包含三部分：错误类型、出错位置、以及可能的建议。例如：

错误使用 *
内部矩阵维度必须一致。
出错 my_first_script (第 8 行)
y = x * z;

这条信息告诉用户：错误发生在第 8 行，原因是矩阵乘法维度不匹配。排查方法是检查 size(x) 和 size(z)，确认是否应该用 .*（逐元素乘法）。

5.3 断点调试：F5 之外的运行方式

对于复杂脚本，直接 F5 可能不够。MATLAB 提供了断点（Breakpoint）机制：在编辑器行号左侧点击，出现红点即设置断点。此时按 F5，程序会在断点处暂停，进入调试模式。调试模式下可用的快捷键包括：

• F10（Step）：单步执行，不进入函数内部。
• F11（Step In）：单步执行，进入函数内部。
• Shift+F11（Step Out）：跳出当前函数。
• F5（Continue）：继续执行到下一个断点。
• F12（Stop）：停止调试。

本文评述：断点调试是脚本学习中最有价值的技能之一，但很多入门教程只讲 F5，不讲断点。F5 让你"看到结果"，断点让你"看到过程"。对于理解循环、条件分支、以及变量在每一步的变化，断点调试的效果远胜于在代码中插入 disp 语句。

拓展资源：MathWorks 官方"Debug MATLAB Code Files"文档页 mathworks.com/help/matlab/matlab_prog/debugging-process-and-features.html；YouTube 上 "MATLAB Debugging" 相关教程视频亦可参考。

六、保存到当前文件夹：编码、换行符与版本兼容

6.1 保存位置的工程意义

"保存到当前文件夹"看似是一个简单的文件操作，但它决定了脚本的执行上下文。如果保存到其他位置，该位置必须被添加到搜索路径，否则脚本中的函数调用可能失败。因此，保存位置不是"文件放哪"的问题，而是"脚本在哪个上下文中被执行"的问题。

对于第一个脚本，建议的目录结构是：

MATLAB_Learning/
├── scripts/
│   ├── my_first_script.m
│   └── data_processing.m
├── functions/
│   └── my_helper.m
├── data/
│   └── sample.csv
└── README.md

这种结构的优点是：脚本、函数、数据分离，便于版本控制和协作。本文评述：初学者常把所有文件堆在一个文件夹里，这在文件数少于 10 个时问题不大，但一旦超过 20 个，查找和维护成本会急剧上升。从第一个脚本开始就建立目录习惯，是低成本高回报的工程实践。

6.2 编码格式：UTF-8 与 GBK 的坑

MATLAB 从 R2020a 起默认使用 UTF-8 编码保存 .m 文件。在此之前，Windows 平台默认使用系统区域编码（中文系统为 GBK）。这导致一个常见问题：在旧版本 MATLAB 中创建的含中文注释的脚本，在新版本中打开可能乱码，反之亦然。

解决方案是在 Preferences → General → Encoding 中统一设置为 UTF-8。对于已有乱码文件，可用 native2unicode 或外部编辑器（如 VS Code）转换编码。本文评述：编码问题在单机环境下可能多年不遇，但一旦涉及跨平台协作或版本升级，就会集中爆发。统一使用 UTF-8 是当前最稳妥的选择，也与 Git 等工具的默认行为一致。

6.3 换行符：CRLF 与 LF

Windows 使用 CRLF（\r\n）作为换行符，Linux/macOS 使用 LF（\n）。MATLAB 能识别两种格式，但混合使用可能导致某些工具报错。Git 提供了 core.autocrlf 配置来自动转换。对于 MATLAB 脚本，建议在 .gitattributes 中声明：

*.m text eol=lf
*.mlx binary
*.mat binary

6.4 版本兼容性检查

MATLAB 每年发布两个版本（a 版和 b 版），新版本引入的函数在旧版本中不可用。若脚本需要在多个版本上运行，可使用 verLessThan 做版本判断：

if verLessThan('matlab', '9.10')  % R2021a
    error('本脚本需要 R2021a 或更高版本');
end

本文评述：版本兼容是工程脚本的必修课。在学术环境中，用户往往无法控制 MATLAB 版本；在工业环境中，版本升级需要审批流程。因此，脚本中显式声明版本要求，比依赖"应该能跑"的假设更可靠。

七、从脚本到工程：可维护性的演进路径

7.1 脚本的局限

脚本虽然方便，但随着代码量增长，其局限逐渐显现：

• 变量污染：所有变量都在 Base 工作区，容易冲突。
• 难以复用：脚本无法接受参数，只能通过修改代码来改变行为。
• 难以测试：没有明确的输入输出，单元测试无从下手。
• 命名冲突：脚本名即函数名，容易与内置函数或其他脚本冲突。

7.2 何时该把脚本改成函数

判断标准可以简化为三个问题：这段代码会被重复使用吗？它需要接受不同的输入吗？它需要被测试吗？如果任一答案为"是"，就应该考虑函数化。MATLAB 从 R2016b 起支持在脚本末尾定义局部函数（local functions），这为渐进式重构提供了便利：

% 脚本主体
data = load('sample.csv');
result = process_data(data);
disp(result);

% 局部函数
function out = process_data(in)
    out = mean(in, 'omitnan');
end

本文评述：局部函数是脚本向工程化过渡的桥梁。它保留了脚本"一键运行"的便利，同时把可复用逻辑封装进函数，减少了工作区污染。对于学习阶段的用户，这是比"直接写函数文件"更平滑的演进路径。

7.3 MATLAB Project：工程化的终极形态

MATLAB 从 R2019a 起引入 Project（.prj 文件），用于管理多文件工程。Project 提供了路径管理、启动脚本、依赖分析、版本控制集成等功能。对于个人学习脚本，Project 可能显得"重"；但对于团队协作或长期维护的项目，它是值得投入的基础设施。

MathWorks 在 R2023b 中增强了 Project 的依赖分析能力，可以自动检测文件间的调用关系。本文评述：从"第一个脚本"到"第一个 Project"，中间的距离不是技术难度，而是工程意识的转变。建议学习者在掌握脚本和函数后，尝试用 Project 组织一个小型项目，体验路径管理和依赖分析带来的秩序感。

八、常见报错与排查对照表

以下表格整理了第一个脚本阶段最常见的报错信息、原因与解决方案。数据来源为 MathWorks 官方错误信息文档、MATLAB Answers 社区高赞问答（2021–2024），以及笔者实测整理。

报错信息	常见原因	解决方案
未定义函数或变量 'xxx'	文件不在当前文件夹或搜索路径	cd 到文件所在目录，或 addpath
无法保存文件，名称无效	文件名含非法字符或与内置函数同名	改用英文、字母开头的名称
内部矩阵维度必须一致	矩阵乘法维度不匹配	检查 size，确认是否应用 .* 而非 *
索引超出矩阵维度	访问了不存在的行列	用 size 检查矩阵维度，MATLAB 索引从 1 开始
脚本中的函数定义无效	函数定义不在脚本末尾	将局部函数移到脚本最后
找不到文件或目录	load/readtable 路径错误	使用绝对路径或 fullfile 拼接

本文评述：报错信息不是敌人，而是最诚实的老师。MATLAB 的错误信息通常包含"错误类型 + 位置 + 原因"，逐字阅读往往就能定位问题。初学者常犯的错误是"看到红色就慌"，跳过错误信息直接搜索。建议养成"先读错误信息，再动手排查"的习惯。

九、前沿视角：MATLAB 脚本在现代计算工作流中的位置

9.1 与 Python/Jupyter 的对比

在数据科学和科学计算领域，Python + Jupyter Notebook 已成为 MATLAB 的主要竞争者。两者的脚本模型有相似之处（都支持交互式执行和文件化脚本），但设计哲学不同。Jupyter 的 .ipynb 是 JSON 格式，包含代码、输出和元数据；MATLAB 的 .m 是纯文本，.mlx 是富文本包。

本文评述：MATLAB 脚本的优势在于"工程一致性"——脚本、函数、工具箱、Simulink 模型共享同一套路径和命名规则；Jupyter 的优势在于"生态开放性"——可调用任意 Python 库，易于与 Web 服务集成。选择哪种工具，取决于项目需求而非工具优劣。对于控制系统、信号处理、通信等传统工程领域，MATLAB 仍有明显优势；对于机器学习、Web 部署、数据管道，Python 生态更成熟。

9.2 云端的 MATLAB：MATLAB Online 与脚本执行

MATLAB Online 允许用户在浏览器中运行 MATLAB，脚本保存在 MathWorks 云端。这改变了"当前文件夹"的概念——云端有独立的文件系统，本地文件夹需要通过上传或 Drive 挂载访问。MathWorks 在 R2023a 后增强了 MATLAB Online 的文件管理能力，支持与 OneDrive、Google Drive 等集成。

本文评述：云端执行对"第一个脚本"的教学有积极意义——它消除了安装和路径配置的门槛。但云端环境也带来了新的路径问题：本地能跑的脚本，上传后可能因路径差异而报错。因此，理解"当前文件夹"的相对性，在云端时代反而更重要。

9.3 AI 辅助编程对脚本编写的影响

MATLAB 从 R2023a 起集成了 AI 辅助功能（如 MATLAB Copilot 的实验性支持），可以根据自然语言描述生成代码片段。这改变了脚本编写的起点——用户可能不再从空白文件开始，而是从 AI 生成的草稿开始修改。

本文评述：AI 辅助降低了"写出第一行代码"的门槛，但没有降低"理解代码在做什么"的门槛。对于学习者，AI 生成的代码仍需逐行理解、调试、验证。因此，本文所讲的执行模型、路径机制、调试方法，在 AI 时代不仅没有过时，反而更加重要——因为你需要足够的知识来判断 AI 生成的代码是否正确。

十、结语：把"第一步"走扎实

回到文章开头的问题：为什么"第一个脚本"值得认真对待？因为它不是一次性的入门操作，而是 MATLAB 使用习惯的起点。新建 .m 文件的方式、保存的位置、运行的方法、调试的手段——这些看似琐碎的选择，会在后续的每一个项目中重复出现。

本文以"执行上下文三要素"为主线，串起了从新建文件到工程化的完整路径。核心观点可以概括为三句话：脚本是批处理化的命令行，不是简化版函数；当前文件夹是路径解析的第一优先级，理解它才能理解"文件找不到"；F5 是入口不是全部，断点调试才是理解代码执行过程的钥匙。

对于正在写第一个脚本的读者，笔者的建议是：不要满足于"能跑就行"。花十分钟理解文件保存的位置、花五分钟设置一个断点、花两分钟读一遍错误信息——这些投入会在你写第 100 个脚本时成倍回报。

主要参考文献