创建实时脚本

R2026b

实时脚本是在一个交互式环境中同时包含代码、输出和格式化文本的程序文件。在实时脚本中，您可以编写代码并查看生成的输出和图形以及相应的源代码。添加格式化文本、图像、视频、超链接和方程，以创建可与其他人共享的交互式记叙脚本。

创建实时脚本

要创建实时脚本，请转到主页选项卡并点击新建实时脚本 。

如果您已有一个脚本，可以将其以实时脚本方式打开。以实时脚本方式打开脚本会创建一个文件副本，并保持原始文件不变。MATLAB® 会将原始脚本中的发布标记转换为新实时脚本中的格式化内容。要通过编辑器将现有脚本以实时脚本方式打开，请右键点击文档选项卡，然后从上下文菜单中选择将 scriptName 以实时脚本方式打开。或者，转至编辑器选项卡并点击保存 > 另存为。然后，将保存类型选项设置为 MATLAB 实时代码文件(*.m)，并点击保存。

添加代码

创建实时脚本后，您可以添加并运行代码。例如，添加以下代码，以绘制随机数据矢量图，并在绘图中的均值处绘制一条水平线。

n = 50;
r = rand(n,1);
plot(r)
m = mean(r);
yline(m)
title("Mean of Random Uniform Data")

New live script with code that plots a vector of random data and its mean

运行代码

要运行当前节中的代码，请点击代码左侧的斜纹竖条。也可以转到实时编辑器选项卡并点击运行 。点击运行按钮会运行实时脚本中的所有代码。

当您的程序正在运行时，系统会在编辑器窗口左上方显示一个状态指示符 。代码行左侧的灰色闪烁条指示 MATLAB 正在计算的行。要导航至 MATLAB 正在计算的行，请点击状态指示符。

如果 MATLAB 在运行前检测到您的代码中存在重大问题，或 MATLAB 在运行实时脚本时发生错误，状态指示符会变为错误图标 。要导航至相应错误，请点击该图标。代码行右侧的错误图标 指示该错误。对应的错误消息会作为输出显示。

您不需要保存实时脚本即可运行它。

保存实时脚本

要保存实时脚本，请转至实时编辑器选项卡，然后点击保存 。或者，使用 Ctrl+S 键盘快捷方式。输入实时脚本的名称并点击保存。默认情况下，MATLAB 使用实时代码文件格式 (.m) 保存文件。有关详细信息，请参阅Live Code File Formats。

显示输出

默认情况下，输出显示在代码右侧，并与创建该输出的代码行对齐。当您滚动内容时，输出会与对应代码保持对齐。要调整代码面板和输出面板的宽度，请拖动两个面板之间的调整大小栏。

要关闭同步滚动，请右键点击输出部分并选择禁用同步滚动。当同步滚动关闭时，代码面板和输出面板会独立滚动。

plotRand live script with output to the right of the code. The vertical resizer bar appears between the live script code and its output.

清除输出

要清除单个输出，请右键点击输出或创建输出的代码行，并选择清除输出。

要清除全部输出，请右键点击脚本中的任意位置，并选择清除全部输出。或者，转到视图选项卡，并在输出部分中，点击清除全部输出按钮。

在单独窗口中打开输出

要在一个单独窗口中打开单个输出，如一个变量或图窗，请点击输出右上角的“查看变量”或“在图窗窗口中打开”按钮 。变量将在变量编辑器中打开，而图窗将在新图窗窗口中打开。

在实时脚本之外更改变量或图窗不会影响实时脚本中显示的输出。

修改图窗

要修改输出中的图窗，请使用图窗坐标区右上角或图窗工具条中的工具。如果工具在图窗坐标区中不可见，请点击“展开坐标区工具栏”按钮 以展开坐标区工具栏。您可以使用这些工具来探查图窗中的数据，并添加格式设置和注解。

有关详细信息，请参阅修改实时脚本中的图窗。

使用键盘与输出交互

要使用键盘与输出交互，请将焦点从代码移到输出，然后激活输出。

  • 要在输出位于右侧时移动焦点，请按 Ctrl+Shift+O 键。在 macOS 系统上，请按 Option+Command+O 键。

  • 要在输出为内嵌时移动焦点，请使用向下箭头和向上箭头键。

  • 要激活选定输出，请按 Enter 键。

激活输出后，您可以：

  • 使用箭头键滚动文本。

  • 使用 Tab 键在超链接和按钮之间导航。

  • 按 Shift+F10 键打开上下文菜单。

  • 按 Esc 键反激活输出。

要禁用内嵌输出的键盘焦点，请在主页选项卡的环境部分中，点击 设置。选择 MATLAB > 编辑器/调试器 > 显示，并清除当输出为内嵌时使用键盘将焦点置于输出选项。

更改视图

通过更改显示输出的位置以及是否在实时脚本中显示代码，您可以为当前工作流优化实时脚本的布局。要更改实时脚本的布局，请转至视图选项卡，在视图部分，从可用选项中进行选择。您还可以选择实时脚本右上角的一个布局按钮。视图选项卡中的选项以及布局按钮仅影响活动的实时脚本。

要更改所有新实时脚本的输出的默认位置，请在主页选项卡的环境部分中，点击 设置。选择 MATLAB > 编辑器/调试器 > 显示，然后为实时编辑器默认视图选择其他选项。

“右侧输出”视图

在“右侧输出”视图中，输出显示在代码右侧。每个输出显示在创建该输出的代码行的旁边。这种布局非常适合编写代码。

plotRand live script with code on the left and the resulting output to the right

“内嵌输出”视图

在“内嵌输出”视图中，每个输出都显示在创建该输出的代码行下方。这种布局非常适合共享。

plotRand live script with code at the top and the resulting output under the line that creates it

“隐藏代码”视图

在“隐藏代码”视图中，代码会隐藏，仅显示输出、带标签的控件、任务和格式化文本。如果您希望其他人仅更改实时脚本中控件的值，而不是直接与代码交互，则此布局非常适合共享。

SolarPanelEstimatorForm live script with a drop-down list, two sliders, and a button that allows a user to specify inputs and start a calculation. All code is hidden.

设置文本格式

您可以将格式化文本、图像、视频、超链接和方程添加到实时脚本中，以创建要与其他人共享的可演示文档。例如，将标题和某些介绍性文本添加到 plotRand 实时脚本：

  1. 将光标放在实时脚本的顶部，然后在实时编辑器选项卡上点击文本 。一个新的文本行将显示在代码上方。

  2. 点击“选择样式”按钮 并选择标题。

  3. 添加文本 Plot Random Data。

  4. 在光标仍置于行中时，点击“居中对齐”按钮 以将文本居中。

  5. 按 Enter 键移到下一行。

  6. 键入文本 This script plots a vector of random data and draws a horizontal line on the plot at the mean.

当您将格式化文本添加到实时脚本时，第一个代码行号会更新为 3。原因是在使用纯文本实时代码文件格式保存的实时脚本中，每行文本在保存的文件中占用一个或多个代码行。

有关所有可用格式化选项的详细信息，请参阅在实时脚本中设置文本格式。

plotRand live script with the centered title Plot Random Data and a line of introductory text, followed by code and its output. The line number for the first line of code is 3.

另请参阅

主题