干过一段时间 Simulink 仿真的人，几乎都遇到过这个场景：Scope 里一次性拉进来五六条信号，波形叠在一起，颜色花花绿绿，但盯着屏幕看了半天，就是不知道哪条线是哪个变量。尤其在电机控制、整车 VCU 策略验证这种信号特别多的模型里，这种“波形认亲”的尴尬几乎每隔几天就来一次。给 Scope 模块添加图例（Legend），就是解决这个问题最直接的办法。
这篇文章会从最常规的界面操作讲起，再深入到信号命名规范、MATLAB 脚本批量控制，最后把图例相关的坑都列一遍。适合刚接触 Simulink 的初学者，也适合已经在调模型但一直被波形可读性折磨的工程师。看完之后，你应该能在一分钟内给任意一个 Scope 配上像样的图例，并且知道图例为什么有时显示不出信号名、怎样让它乖乖听话。
1. Scope图例是什么：从一次“波形认亲”开始
1.1 没有图例的Scope窗口有多头疼
我最早用 Simulink 做仿真的时候，图省事，Scope 里直接接一堆信号，线也不命名。结果就是仿真跑完，波形出来了，我却花了好几分钟去猜哪条是转速、哪条是电流、哪条是参考值。后面模型越搭越大，一个 Scope 里塞了七八个信号，颜色区分度眼看就到极限了，再想靠“这根是红的、那根是蓝的”来记忆，完全行不通。
有人可能会说，每条信号线可以单独设置颜色和线型，红色是 A 信号，蓝色是 B 信号，这不是也能区分吗？确实能，但这属于“硬记颜色”的土办法，一旦重新仿真、信号顺序变化、或者同事接手你的模型，这些颜色对应关系就彻底断了。更麻烦的是，Scope 窗口里的波形线颜色是自动分配的，关了再开就可能变，靠颜色认信号的方案一碰就碎。
图例的本质，就是把“颜色”和“信号名称”的对应关系固定下来，让波形曲线旁边直接出现一个标识条，告诉你哪条线是什么。它不需要你额外记录任何东西，眼睛扫一下就知道当前 Scope 里显示的是哪些变量。这个功能在联合仿真、外部模式调试、以及生成报告前的波形整理阶段，尤其有用——调控制参数的时候，你希望一眼看出参考值和反馈值之间的偏差趋势，而不是花时间分辨颜色。
1.2 图例功能支持的基础条件与版本差异
不是所有 Scope 天生就能显示图例。如果用的是非常老版本的 Simulink，Scope 窗口就是一整个独立的示波器界面，菜单里根本没有“Legend”这个选项。新版本里，把鼠标移到 Scope 窗口顶部，能看到一排工具栏按钮，其中一个带“图例”图标的按钮，以及 View 菜单底部的 “Legend” 选项，就是这个功能的入口。
这里要说明一下版本差异：Simulink 在近几个大版本里一直在改进 Scope 的交互体验，新版 Scope 窗口的图例功能相对成熟，打开后可以随意拖动位置，图例条目也会随信号数量自动增减。老模型如果直接从旧版本迁移过来，有时候会遇到图例按钮是灰的，原因多半是 Scope 被封装成了子系统，或者用的是已经废弃的浮动 Scope（Floating Scope）模式。遇到这种情况，我会直接建议：别在老树上纠结，换成新的 Scope 配置或者用后面讲的脚本方案，反而省时间。
判断自己的模型能不能用图例，有一个很简单的方法：点击 Scope 块看左侧属性面板，如果在“Main”选项卡下能看到“Legend”相关字段，那说明支持；如果完全没有，那就是老式 Scope，需要另想办法。最稳妥的替代方案，是先把数据导到 MATLAB 工作区再用 plot 函数画图，想怎么加图例都行。
2. 两分钟给Scope加上图例：常规操作路径
2.1 从View菜单或工具栏打开Legend
给 Scope 加图例，最基础的操作就是打开 Scope 窗口，找到工具栏上的图例按钮，或者通过 “View → Legend” 菜单打开。不同 Simulink 版本里菜单位置可能有一点差异，但基本都在视图类菜单里。点击之后，图例就会出现在 Scope 窗口的左上角区域，默认会列出每条曲线的名称和对应的线色。
这里要注意一个细节：图例打开后的状态，会跟随模型保存。也就是说，你在某一个 Scope 上打开了图例，保存模型，下次重新打开模型再仿真，图例依然在。这个特性非常重要，因为这意味着花几分钟把图例配置好，以后每次打开模型都能直接复用，不用反复设置。我在团队项目里经常提醒同事：Scope 图例不是临时查看工具，它应该作为模型可视化的一部分，随模型一起交付。
如果你打开模型后发现某些 Scope 的图例没开，也不要一个个点进去了，后面第四部分会给出脚本批量开启的方法。但前提是你得先知道图例开出来长什么样、能显示什么内容，所以先动手在单个 Scope 上试一次。
2.2 图例显示了什么：信号名、端口名与总线名
打开图例后，第一眼看到的内容往往有两个层次。第一种情况，信号线本身有名字，图例就直接显示这个名字，比如 “speed_ref”“torque_fb” 这种。第二种情况，信号线没有名字，图例就会显示 “Port 1”“Port 2” 这样的占位名，意思是“这个端口接进来的第一路信号”。如果你看到图例里全是 Port 开头，那基本可以断定：信号没有命名，或者命名在连线过程中被抹掉了。
有一点比较容易忽略：如果 Scope 接的是 Bus 信号，图例通常会按总线元素展开，显示的是总线里每个元素的名字。如果 Scope 接的是 Mux 块，图例会显示 Mux 内部每一条输入线的名字，前提是每条输入线都有名字。至于来自 Goto/From 模块的信号，图例显示的就是对应的 Goto 标签名。了解这些规则以后，你就知道图例显示的问题往往不在图例本身，而在上游信号的信息传递链上。
2.3 拖不动、看不清？图例的显示与交互技巧
图例打开之后，默认在窗口左上角，但它不是固定死的。你可以直接用鼠标按住图例区域的边缘，把它拖到窗口的右侧、底部或者任意你认为不挡波形的地方。这个拖动位置在模型保存后同样会保留，所以放心大胆调。
碰到两个比较常见的交互问题。一个是图例字体太小，尤其在高分辨率屏幕上，波形标题都看不清，更别说图例里的文字。这时候可以用 Scope 窗口的缩放快捷键，比如按住 Ctrl 滚动鼠标滚轮，整体放大显示，图例文字也会跟着变大。另一个是图例和波形重叠，拖开一次下次又回来了——这种情况多半是你拖动的是 Scope 窗口里的其他元素，或者模型没保存成功，调整完之后记得保存。
还有一个容易被忽略的点：当 Scope 窗口处于浮动状态，或者你在 Simulink 外部单独打开了 Scope 窗口时，图例的显示和保存行为可能会不太稳定。所以我的习惯是，所有图例设置和位置调整，都在模型内的 Scope 窗口上完成，不要依赖浮动窗口里的临时状态。
3. 让图例“听话”：信号命名规范与图例联动
3.1 信号线命名对图例内容的影响
图例显示的内容直接取决于信号线上的名字，所以信号命名问题才是图例好不好用的关键。给信号线命名的方法很简单：双击信号线，变成可编辑状态，直接输入名字，回车确认。也可以用鼠标选中信号线后右键，选择 “Signal Properties”，在弹出的对话框里输入 Signal name。
我在实际项目里有一个硬性要求：凡是进入 Scope 的信号，必须有名字，且名字要能表达物理含义。比如电机控制模型里，我不允许出现 “Sin1”“Signal2” 这种东西，必须是 “Id_ref”“Iq_fb”“speed_act” 这类一看就明白的命名。这么做的原因很简单：Scope 图例把名字亮出来，就是要给人看的，如果名字本身没意义，图例也就失去了存在的价值。
如果你预算再充足一点，建议信号名里带上单位，比如 “torque_ref_Nm”“battery_current_A”。别担心太长，Scope 图例显示长名字的能力比你想的强，而且带单位的信号名在后续生成报告、团队评审的时候特别省事，别人不用翻模型就知道这个信号是什么、用什么单位度量的。
3.2 从Goto/From、Bus与Data Store看命名规则
信号线直接命名是最常见的方式，但模型中大量信号会经过 Goto/From 标签传递，或者打包成 Bus 总线，这时候图例显示的规则会有些许变化。先说 Goto/From：如果 Scope 的输入来自 From 块，图例显示的是 Goto 标签名，不是 From 块自己的名字。这一点容易混淆——你以为在 From 块里改个名字就完事了，结果图例没变，其实是 Goto 块那边的标签没改。
再说 Bus 信号：Scope 如果接入一个 Bus，图例往往按总线内部元素展开。比如你有一个 Bus 包含 “motor_speed”和“motor_torque”两个元素，Scope 图例里就会显示这两条，线色也各自独立。这对调试非常友好，但前提是你的 Bus 元素命名要规范。建 Bus 对象的时候，我习惯在 Bus Editor 里直接给每个元素起好有意义的名字，而不是用默认的 element1、element2。
Data Store Memory 的情况稍微特殊一点，它本质上是全局数据区，Scope 直接接 Data Store Read 的输出时，图例显示的是 Data Store Read 模块的输出信号线上的名字，而不是 Data Store Memory 的名字。所以遇到这种模块，你还是得回到“信号线命名”这个最底层的规则上来。
3.3 浮动Scope与仿真数据查看器中的图例
浮动 Scope 在早期 Simulink 版本里相当流行，它可以不接线，通过列表选择要显示哪些信号。但浮动 Scope 的图例体验很一般：信号多了以后列表和图例容易脱节，而且在新版本里已经被官方逐渐边缘化。如果你还在用浮动 Scope，我的建议是尽早迁移到仿真数据查看器（Simulation Data Inspector，简称 SDI）。
SDI 本质上是一个比 Scope 强大得多的数据浏览工具，它可以同时显示多个仿真运行结果、自动记录全部信号、并且每一条信号都有清晰的图例标识和颜色管理。从操作习惯来说，SDI 的“信号列表”比 Scope 图例更直观，你不需要思考哪条线对应哪个变量，直接在列表里勾选就行。如果你正在做 Carsim 与 Simulink 联合仿真、或者在做快速原型验证，用 SDI 辅助对比多次仿真结果，会明显比盯一个 Scope 窗口高效。
不过 SDI 也有它的缺点：它是独立于模型的工具，不像 Scope 那样“所见即所得”地嵌在模型里。所以我的习惯是两者搭配使用：模型内部保留带图例的 Scope，用于日常调试时实时观察；事后对多组数据做对比分析、做报告图表时，用 SDI 或 MATLAB 脚本完成。
4. 批量处理与脚本化控制：MATLAB命令给图例“开挂”
4.1 用get_param/set_param开关图例
当模型里 Scope 数量多起来以后，一个个点图例按钮就太累了。想象一个整车控制模型，里面有二十几个 Scope，分布在不同的子系统里，你想统一开启图例，手动操作至少得几分钟，还容易漏。这时用 MATLAB 脚本批量控制，几秒钟就搞定。
核心思路是先用find_system找到模型里所有 Scope 块，再用set_param设置图例相关参数。代码如下：
% 查找当前模型下的所有Scope块 scopes = find_system(bdroot, 'BlockType', 'Scope'); for i = 1:numel(scopes) set_param(scopes{i}, 'ShowLegend', 'on'); end这里bdroot表示当前打开的顶层模型，find_system默认会递归查找所有层次的子系统，所以能一次性抓到模型里所有 Scope。ShowLegend参数就是图例开关，取值是字符'on'或'off'。执行这一段，所有 Scope 的图例都会被打开。
如果想批量关闭，把'on'改成'off'就行。还有一点要提醒：如果模型里混着老版本 Scope，ShowLegend参数可能不存在，运行时报告错。所以更稳妥的写法是先检查参数是否存在，再决定是否设置。
4.2 通过ScopeConfiguration对象精确控制
新版 Simulink 把 Scope 的很多属性集中到了一个配置对象里，通过get_param(scopePath, 'ScopeConfiguration')可以拿到。这种方式不仅支持开图例，还能控制图例位置、网格显示、时间轴范围等，灵活性更高。
% 先获取某个Scope的配置对象 cfg = get_param('myModel/Scope1', 'ScopeConfiguration'); % 开启图例 cfg.ShowLegend = true; % 设置图例位置，可选值通常包括 northeast/northwest/southeast/southwest 等 cfg.LegendLocation = 'northeast';我实际用得最多的是同时设置好几个属性：开图例、打开仿真开始自动弹出窗口、设置网格。这样每次仿真结束，窗口就会带着图例出现在固定位置，基本不用额外操作。下面是组合写法：
cfg.ShowLegend = true; cfg.LegendLocation = 'southeast'; cfg.OpenScopeAtSimulationStart = true; cfg.DisplayGrid = 'on';注意，DisplayGrid在不同版本里也可能是布尔值或者字符串，具体以你当前版本的文档为准。但思路是一致的：Scope 的显示方式完全可以通过脚本统一管理。
4.3 一键遍历全模型Scope的实用脚本
为了让大家真正能“抄作业”，我把前面几段逻辑整合成一个通用函数。它做的事情是：自动查找模型下所有 Scope，对支持图例参数的设置开启图例，对不支持的记录下来并提示。这个脚本我一直在用，适配新老混用的模型环境。
function enableAllScopeLegend(modelName) % 开启模型中所有Scope的图例 % 输入参数可选，缺省时使用当前打开的模型 if nargin < 1 || isempty(modelName) modelName = bdroot; end % 确保模型已加载 if ~bdIsLoaded(modelName) load_system(modelName); end scopeBlocks = find_system(modelName, 'BlockType', 'Scope'); legacyScopes = {}; for i = 1:numel(scopeBlocks) try % 获取该模块的对话框参数列表 params = get_param(scopeBlocks{i}, 'DialogParameters'); if isfield(params, 'ShowLegend') set_param(scopeBlocks{i}, 'ShowLegend', 'on'); else legacyScopes{end+1} = scopeBlocks{i}; end catch legacyScopes{end+1} = scopeBlocks{i}; end end % 打印不支持的Scope if ~isempty(legacyScopes) fprintf('以下Scope可能为旧版本，未自动开启图例：\n'); for j = 1:numel(legacyScopes) fprintf(' %s\n', legacyScopes{j}); end else fprintf('所有Scope的图例均已开启。\n'); end end把这个函数保存为enableAllScopeLegend.m，放在 MATLAB 当前路径下，之后只要在命令行输入enableAllScopeLegend就能给当前模型里所有 Scope 开启图例。我通常还会在函数里加一段输出，把没命名的信号列出来，提醒自己哪些地方信号命名不规范，这样不但解决了图例问题，还顺带做了信号命名审计。
5. 常见问题与排查实例
5.1 图例显示Port 1而不是信号名
这个问题出现频率最高。图例显示 “Port 1” 而不是真实信号名，根本原因就是信号线上没有可显示的名字。解决思路很简单：双击信号线，输入一个有意义的名字。但要注意一个细节：有时你明明改了名字，仿真之后图例还是显示 Port，这时候要看名字是否被后面连线的操作覆盖了。比如你用鼠标拖了一根新线覆盖旧线，旧线的名字可能就没了。
排查步骤我一般是这样：先点选 Scope 的输入信号线，看属性面板里 “Signal name” 字段是否有内容。如果是空的，直接命名；如果有名字但图例不显示，那多半是信号经过了一些特殊处理，比如从 bus selector 或 demux 输出的信号，名字被拆散了，这时候要在 bus selector 的输出信号线上重新命名，或者用 signal conversion 块把名字固定下来。
还有一个常见坑：信号线名字中含有中文或特殊字符时，部分版本图例显示会出问题。我的建议是坚持用英文加下划线命名，比如 “speed_feedback”，既方便脚本处理，也避免跨版本兼容性隐患。
5.2 图例丢失、错位与导出图片问题
有些情况下，你明明打开过图例，但再次仿真后图例不见了。排查思路先看模型是否保存，再看是否有人覆盖了你的模型版本。图例位置错位也是常见现象，尤其是不同电脑分辨率不同，图例位置在 A 电脑上看着正常，到 B 电脑上就跑偏了。这是正常现象，重新拖一下，保存模型即可。
导出图片方面，很多人在模型评审前想把 Scope 窗口截图放进报告，结果发现导出的图里没有图例。这个问题多半出在导出方式上。如果你用系统截图，图例肯定在里面；如果你用 “File → Print to Figure” 或者另存图片，部分版本默认不包含图例。我的办法是直接截图，或者用print函数把 Scope 窗口保存为图片时，确保窗口焦点在 Scope 上且图例已经展开：
% 把Scope窗口内容保存为PNG图片 print(gcf, '-dpng', 'scope_output.png');如果你对图片质量和排版有更高要求，我建议直接把数据导出来，在 MATLAB 里用plot和legend重新画图。虽然多了一步，但图例、坐标轴、线型、字号全部可控，做出的图放在报告里比 Scope 截图更专业。这也是我最后最推荐的方式，Scope 图例适合实时调试，正式报告里的波形还是交给 MATLAB 绘图更稳。
5.3 图例在版本升级后参数失效怎么办
Simulink 更新换代以后，有时打开旧模型会发现某些 Scope 图例设置丢了。这不是模型损坏，而是新版本对 Scope 配置对象的结构做了调整，旧参数被新参数替代了。遇到这种情况，不用一个 Scope 一个 Scope 去点，直接运行之前提供的enableAllScopeLegend脚本，一行命令把所有图例重新拉起来就行。
更进一步的建议是把图例设置固化到模型模板里。在建新模型时，预先在模板中打开所有关键 Scope 的图例、设置好布局，这样团队里每个人新建模型时自动继承这些设置，从源头上减少版本迁移带来的设置丢失问题。我自己在团队里就是这么做的，模板文件里已经批量开启了图例，新同事上手模型后基本不会因为这种细枝末节卡壳。
5.4 用MATLAB绘图替代Scope图例
写这一条，是给那些做正式报告、论文、或者需要严谨结果展示的朋友。Scope 图例再方便，它的定位仍然是“软件界面上的辅助显示”，而不是“出版级图表”。当你需要对波形进行详细标注、设置坐标轴范围、统一多张图的配色方案时，Scope 就有点力不从心了。
我的标准做法是：把信号用 To Workspace 模块记录到 MATLAB 工作区，仿真结束后，用脚本一次性绘制所有曲线并添加图例。下面是一个通用示例：
% 仿真结束后在工作区绘制信号并添加图例 t = logsout.get('time').Values.Data; y1 = logsout.get('speed').Values.Data; y2 = logsout.get('torque').Values.Data; figure; plot(t, y1, 'b-', 'LineWidth', 1.5); hold on; plot(t, y2, 'r--', 'LineWidth', 1.5); hold off; xlabel('Time (s)'); ylabel('Value'); legend('speed', 'torque', 'Location', 'best'); grid on;这种方式带来的图例自由度是 Scope 完全比不了的，而且数据已经落到工作区，后续做数据对比、统计分析、生成报表都顺理成章。所以我的结论是：Scope 图例解决日常调试 80% 的可读性问题；剩下 20% 的正式输出需求，用 MATLAB 绘图补上，组合起来基本无敌。
最后再分享一个小技巧
说了这么多，最后分享一个自己实际踩坑总结出来的习惯：不管什么模型，只要是用来调试的，我会在模型最开始搭建的时候就强制要求——关键信号全部命名，Scope 全部开启图例。这个习惯最开始是为了省事，后来发现它带来的好处远超预期：模型评审时不用对着颜色猜变量、半个月后自己回来看模型也不用重新梳理信号对应关系、同事接手项目时上手速度快了很多。图例这个东西看着小，但它其实是模型可读性的一个缩影，重视它的人，做出来的模型一般都不会差到哪里去。
