Main Content

编辑器/调试器预设项

您可以使用“编辑器/调试器”预设项自定义编辑器、实时编辑器和调试器的显示和功能。

编辑器/调试器的常规预设项

可以指定 MATLAB® 使用的编辑器,以及 MATLAB 编辑器和实时编辑器在各种情形下的行为方式。

主页选项卡的环境部分,点击 预设。选择编辑器/调试器,然后按下表所述调整预设选项。

某些常规预设项在 MATLAB Online™ 中不可用。

预设项用法

编辑器

选择您希望 MATLAB 桌面在您编辑文件时使用的编辑器:

  • MATLAB 编辑器

  • 文本编辑器

如果您选择文本编辑器,请指定您要使用的编辑器应用程序的完整路径,例如 Emacs 或 vi。例如,c:/Applications/Emacs.exe

此预设项仅适用于纯文本文件,例如扩展名为 .m.txt 的文件。

最近使用的文件列表

条目数字段中,键入您要在文件菜单底部的最近使用的文件列表中显示的文件数。

在编辑器中打开文件

如果您希望在重新启动 MATLAB 时重新打开上次 MATLAB 会话期间的编辑器及其所含文件,请选择在重新启动时打开先前 MATLAB 会话中的文件

选择 MATLAB 到达断点时自动打开文件,以便在 MATLAB 在该文件中遇到断点时打开运行中的程序文件。

选择在编辑器中显示文件的完整路径以显示在 MATLAB Online 编辑器和实时编辑器中打开的文件的完整路径。路径显示在每个打开文件的顶部。

文件自动更改

如果希望编辑器或实时编辑器在您点击离开文件时自动保存对文件所做的更改,请选中在文件外点击时保存更改。要在点击离开时自动保存更改,您必须已经至少保存过一次该文件。

MATLAB Online 中,此预设项位于 MATLAB > 编辑器/调试器 > 保存下。

如果目前已在编辑器中打开的文件没有尚未保存的更改,而您希望编辑器自动重新加载您已在 MATLAB 外部打开和编辑的文件版本,请选择重新加载已在外部修改的未编辑的文件

选择在文件结尾添加行终止符可使 MATLAB 将一个新空行(有时称为 <CR>)自动添加到文件末尾(如果文件中的最后一行不为空)。

此预设项仅适用于纯文本文件,例如扩展名为 .m.txt 的文件。

调试

使用显示内联 "步入" 按钮选项指定何时显示内联“步入”按钮。

  • 选择始终以对所有函数和脚本显示该按钮。

  • 选择对于用户定义的函数以仅对用户定义的函数和脚本显示该按钮。

  • 选择从不以从不显示该按钮。

选择自动打开调试器面板以便在 MATLAB 进入调试模式时自动打开调试器面板。清除自动打开调试器面板以禁用自动打开调试器面板。此选项仅在 MATLAB Online 中可用。

编辑器/调试器显示预设项

您可以更改编辑器和实时编辑器的外观。

主页选项卡的环境部分,点击 预设。选择编辑器/调试器 > 显示,然后按下表所述调整预设选项。

预设项用法
常规显示选项

选择高亮显示当前行并选择一种颜色来高亮显示光标(也称为插入光标)所在的行。

此预设项不适用于实时编辑器。

选择显示行号可沿编辑器和实时编辑器窗口左边缘显示行号。

选择在编辑模式下启用数据提示可在您编辑 MATLAB 代码文件时显示数据提示。(在调试模式下始终启用数据提示。)

Code snippet with the cursor on the variable n and a data tip showing the data type and value of n

有关详细信息,请参阅查看变量值

此预设项不适用于实时编辑器。

实时编辑器默认视图中选择选项,以指定创建新实时脚本时的默认输出位置:

  • 右侧输出 - 输出显示在代码的右侧。每个输出都显示创建该输出的代码行。这是编写代码时的理想选项。

    要在输出位于右侧时禁用输出与代码对齐模式,请右键点击输出部分,并选择禁用同步滚动

  • 内嵌输出 - 输出与代码内嵌显示。每个输出显示在创建该输出的代码行的下面。此选项非常适合共享。

选择当输出为内嵌时使用键盘将焦点置于输出以支持在输出为内嵌时使用向上和向下箭头键将焦点移至输出。

如果您需要“以实时脚本方式打开”前注出现在编辑器中文档的顶部,请选择显示 "以实时脚本方式打开" 横幅

右侧文本限制

选择显示行可在编辑器中的指定列(放置)显示具有指定颜色的垂直行。

有关详细信息,请参阅Change the Right-Side Text Limit Indicator

此预设项不适用于实时编辑器。

编辑器/调试器制表符预设项

可以指定制表符和缩进的大小以及有关制表符在编辑器和实时编辑器中的行为方式的详细信息。

主页选项卡的环境部分,点击 预设。选择编辑器/调试器 > 制表符,然后按下表所述调整预设选项。

MATLAB Online 中,这些预设项位于 MATLAB > 编辑器/调试器 > 缩进下。

选项用法
制表符大小

指定在您按 Tab 键时插入的空位量。

在更改制表符大小时,它会更改该文件中现有行的制表符大小,除非您同时选择 Tab 键插入空位

缩进大小

指定自动缩进的缩进大小。要设置自动缩进预设项,请参阅编辑器/调试器语言预设项

Tab 键插入空位

选择此选项可在您按下 Tab 键时插入一系列空位。否则,一个制表符充当一个空位,其长度等于制表符大小

Emac 样式的 Tab 键智能缩进

指定一个与 Emacs 编辑器所采用的样式相似的缩进样式。

当您将光标置于一行中或选择一组行,然后按 Tab 键时,行根据自动缩进预设项进行缩进。要设置自动缩进预设项,请参阅编辑器/调试器语言预设项

如果您选择此预设项,无法在行中插入制表符。

编辑器/调试器语言预设项

您可以指定不同语言在编辑器和实时编辑器中的显示方式。MATLAB 基于打开的文件的文件扩展名应用语言预设项。

主页选项卡的环境部分,点击 预设。选择编辑器/调试器 > 语言,然后按下表所述调整预设选项。

MATLAB Online 中,这些预设项位于编辑器/调试器 > MATLAB 语言编辑器/调试器 > 其他语言下。

并非所有预设项都适用于所有语言。

预设项用法
语言

选择要为其设置预设项的语言。

语法高亮

选择启用语法高亮可使编辑器和实时编辑器对不同语言构造使用不同颜色。然后,调整每个语言元素所要使用的颜色。

要更改 MATLAB 语法高亮颜色,请点击设置语法颜色。有关详细信息,请参阅语法高亮

要更改所有其他语言的语法高亮颜色,请从启用语法高亮下的选项中选择。

变量和函数重命名

仅 MATLAB 语言

选择启用变量与函数的自动重命名可使 MATLAB 在您重命名函数或变量时提示您重命名文件中函数或变量的所有实例。

Automatic variable and function renaming tooltip prompting you to press Shift+Enter to rename all instances of a variable

有关 MATLAB 何时提示您的详细信息,请参阅自动重命名一个文件中的所有变量或函数

注释格式设置

仅 MATLAB 语言

最大列宽度字段中,输入要在一行注释中允许的最大字符数,然后选择希望开始计数的位置。

考虑选择:

  • 从行开头开始(当注释的绝对宽度很重要时)。例如,从行开头开始起设置 75 列以便在您使用编辑器的默认字体时与适合打印页的宽度相匹配。

  • 从注释开头开始(当注释已缩进,且您希望每段注释具有一致的缩进和宽度时)。

选择键入时自动使注释换行可在您在编辑器或实时编辑器文档中键入注释时自动使注释以最大列宽度值换行。

如果您清除此选项,仍可以手动使注释换行,如向代码添加注释中所述。

缩进

选择键入时应用智能缩进以自动:

  • 在循环语句的开头和结尾范围内缩进循环体。

  • 将后续行与您使用制表符或空格缩进的行对齐。

  • 使用函数缩进格式选项指定的方式缩进函数。

还可以在键入代码后手动应用自动缩进。有关详细信息,请参阅Indent Code

函数缩进格式(仅 MATLAB 语言)选择一个选项来指定函数在编辑器和实时编辑器中如何缩进,具体如下所述:

  • 经典 - 编辑器和实时编辑器将函数代码与函数声明对齐。

    Function containing code and a nested function, with the code for each function aligned to the function declaration.

  • 缩进嵌套函数 - 编辑器和实时编辑器缩进嵌套函数中的函数代码。

    Function containing code and a nested function, with the code in the nested function indented from the nested function declaration.

  • 缩进所有函数 - 编辑器和实时编辑器缩进主函数和嵌套函数的函数代码。

    Function containing code and a nested function, with the code for each function indented from their function declaration.

文件扩展名

添加一个或多个要与语言关联的文件扩展名。您为该语言设置的预设项适用于具有列出的扩展名的所有文件。

编辑器/调试器代码折叠预设项

通过代码折叠,您可以展开和折叠 MATLAB 代码块,以便在您不使用的情况下将其隐藏。

主页选项卡的环境部分,点击 预设。选择编辑器/调试器 > 代码折叠,然后按下表所述调整预设选项。

有关代码折叠的示例和详细信息,请参阅Fold Code

代码折叠预设项不适用于实时编辑器。

选项用法
启用代码折叠

指定您是否要对已将其相应的启用复选框选中的编程构造启用代码折叠。

启用

指定您是否要对相应的编程构造启用代码折叠。

如果您对任何构造选择此选项,但清除启用代码折叠选项,则该构造将不会启用代码折叠。

初始折叠指定在您首次打开 MATLAB 文件时,相应的编程构造是否显示为折叠。

编辑器/调试器备份文件预设项

您可以指定是否、何时、如何让 MATLAB 自动备份在编辑器中打开的文件。

主页选项卡的环境部分,点击 预设。选择编辑器/调试器 > 备份文件,然后按下表所述调整预设选项。

备份文件预设项不适用于实时编辑器,在 MATLAB Online 中也不可用。

预设项用法

使用 MATLAB 编辑器时自动创建备份文件

选择此项可使 MATLAB 自动保存您当前所编辑的文件的副本。
保存选项备份保存间隔:n 分钟指定您希望 MATLAB 保存您所编辑的文件副本的频率。

保存无标题的文件可将无标题的新文件保存到 Untitled.asv

当有多个无标题的文件时,每个新增的文件都保存到 Untitledn.asv(其中 n 是一个整数值)。

关闭选项

关闭编辑器时自动删除备份文件会指示 MATLAB 在您关闭编辑器中的源文件时删除备份文件。

如果禁用此选项,则为了确保备份与文件之间关系的清晰且保持最新,请在重命名或删除文件时考虑删除或重命名对应的备份文件。

文件名

选择希望 MATLAB 对于自动保存文件所采用的命名约定。例如:

  • 如果指定将扩展名替换为: asv,则 filename.m 的备份文件为 filename.asv

  • 如果您指定将文件名附加到: ~,则 filename.m 的备份文件为 filename.m~

位置

源文件目录指定您希望将备份文件存储在与所编辑的文件相同的文件夹中。

单个目录指定您希望将自动保存文件存储在单个文件夹中。指定该文件夹的完整路径并确保您对其具有写权限。

如果您编辑只读文件夹中的文件并且备份位置源文件目录,则编辑器不会创建该文件的备份副本。

有关在编辑器中自动创建修改的文件的备份副本的详细信息,请参阅保存和备份代码

编辑器/调试器自动格式化预设项

您可以在实时编辑器中使用自动格式化标记来快速设置实时脚本和函数的格式。您可以整体启用或禁用自动格式化选项,或者单独启用和禁用各选项。

主页选项卡的环境部分,点击 预设。选择编辑器/调试器 > 自动格式化,然后按下表所述调整预设选项。

自动格式化预设项不适用于编辑器。

预设项用法

在实时编辑器中启用自动格式化

选择此项可在实时编辑器中启用自动格式化选项。启用此预设项后,可以单独启用或禁用各选项。

文本格式

选择 *italic*、**bold**,使用星号 (*) 启用粗体和斜体格式。
选择 _italic_、__bold__,使用下划线 (_) 启用粗体和斜体格式。
选择 `monospace`、|monospace|,启用等宽自动格式化。

分节符

选择 %%、*** 或 --- 表示分节符,通过输入 %%***---,然后按 Enter 来插入分节符。
选择 %% 文本表示分节符和标题,通过输入 %%text 然后按 Enter 来插入分节符和标题 1 样式的标题。

插入选项

选择 $LaTeX$ 表示 LaTeX 方程,使用格式 $LaTeX$LaTeX 表达式转换为方程。
选择 URL 表示超链接,将 Internet 路径自动转换为超链接。
选择 <URL> 表示超链接,使用格式 <URL> 将 Internet 路径转换为超链接。
选择 [Label](URL) 表示带标签的超链接,使用格式 [Label](URL) 将 Internet 路径转换为带标签的超链接。
选择 (TM)、(SM)、(R) 和 (C) 表示商标、服务标记和版权符号,以支持使用格式 (TM)(SM)(R)(C) 插入商标和版权符号(™、℠、® 和 ©)。

文本样式

选择 #text 表示标题,以使用格式 #text 插入标题。
选择 ##text、###text 或 ####text 表示标题,以使用格式 ##text、格式 ###text 或格式 ####text 插入标题 1、标题 2 或标题 3。
选择自动项目符号列表(*、+ 或 -),通过输入 *+- 后跟空格来创建项目符号列表。
选择自动编号列表(1、2 等),通过输入 1.2. 等后跟空格来创建编号列表。

有关实时编辑器中的自动格式化的详细信息,请参阅自动格式化

编辑器/调试器自动填充预设项

您可以在编辑器、实时编辑器和 App 设计工具中更改 MATLAB 建议和自动填充名称的方式。您还可以在编辑器、实时编辑器和 App 设计工具中更改 MATLAB 是否自动补全块结尾、括号、引号、注释、字符向量和字符串。

主页选项卡的环境部分,点击 预设。选择编辑器/调试器 > 自动填充,然后按照下表中所述调整预设选项。

预设项用法

建议和自动填充项

选择自动显示建议,以便当您在编辑器、实时编辑器和 App 设计工具中的键入时自动显示建议。如果清除自动显示建议,则仅当您按下 Ctrl+空格键Tab 键时才显示建议。

有关详细信息,请参阅在键入时检查语法

选择使用 Tab 键显示建议(仍支持 Ctrl+空格键),以便当您在编辑器、实时编辑器和 App 设计工具中按下 Tab 键时显示建议。如果清除使用 Tab 键显示建议(仍支持 Ctrl+空格键),则仅在您按下 Ctrl+空格键时才显示建议。

有关详细信息,请参阅在键入时检查语法

选择使用右箭头接受建议(仍支持 Tab 和 Enter 键),以便您在编辑器、实时编辑器和 App 设计工具中使用向右箭头键接受建议。如果清除使用右箭头接受建议(仍支持 Tab 和 Enter 键),则可使用 Tab 键和 Enter 键接受建议。

有关详细信息,请参阅在键入时检查语法

自动编码选项

选择启用自动编码,以在编辑器、实时编辑器和 App 设计工具中启用自动编码选项。启用此选项后,可以单独启用或禁用各选项。

自动填充对组

  • 选择圆括号 ( ) 以自动补全圆括号。

  • 选择花括号 { } 以自动补全花括号。

  • 选择方括号 [ ] 以自动补全方括号。

  • 选择单引号 (' ') 以自动补全单引号。

  • 选择双引号 (" ") 以自动补全双引号。

在新行上自动补全

  • 选择注释(%) 以在按 Enter 键时自动拆分注释。例如,将光标放在下面注释的第一个句点后,然后按 Enter 键。

    % This is my first comment. This is my second comment.
    光标后的文本会移至新行,编辑器会在新行的开头添加百分号 (%)。
    % This is my first comment.
    % This is my second comment.

  • 选择字符向量(' ') 以在按 Enter 键时自动拆分字符向量。例如,将光标放在下面字符向量中的单词 Random 后,然后按 Enter 键。

    title('Mean of Random Uniform Data')
    编辑器会将该字符向量拆分为跨行的两个字符向量。
    title(['Mean of Random' ...
        ' Uniform Data'])

  • 选择字符串(" ") 以在按 Enter 键时自动拆分字符串。例如,将光标放在下面字符串中的单词 long 后,然后按 Enter 键。

    exist("exceptionally_long_file_name.txt")
    编辑器会将该字符串拆分为跨行的两个字符串。
    exist("exceptionally_long" + ...
        "_file_name.txt")

  • 选择圆括号 ( ) 以在按 Enter 键时自动拆分圆括号。例如,将光标放在下面命令中的数字 10 和逗号后,然后按 Enter 键。

    plot(x,y,'--gs','LineWidth',2,'MarkerSize',10,'MarkerEdgeColor','b')
    编辑器会将该命令拆分为两行。
    plot(x,y,'--gs','LineWidth',2,'MarkerSize',10, ...
        'MarkerEdgeColor','b')

自动补全块结尾

  • 选择控制流语句(if、for 等) 以自动补全控制流语句。要自动补全语句,请输入语句并按 Enter 键。有关控制流语句的列表,请参阅循环及条件语句

  • 选择函数和类定义以自动补全函数和类定义。要自动补全定义,请输入 functionclass,然后按 Enter 键。

编辑器/调试器的查找和替换预设项

您可以更改“查找和替换”对话框的行为,包括在 MATLAB Online 中禁用绕回搜索。

主页选项卡的环境部分,点击 预设。选择编辑器/调试器 > 查找和替换,然后按照下表所述调整预设项。

“查找和替换”预设项在 MATLAB 的安装版本中不可用。

选项用法
搜索行为

选择绕回,以在到达文档末尾时从文档开头继续搜索,直到搜索完整个文档。

选择键入时移动光标,在键入搜索短语时将光标移至第一个结果。清除键入时移动光标,仅在输入整个搜索短语后移动光标。

选择突出显示搜索结果以在文档中突出显示所有搜索结果。

搜索文本

选择使用所选内容作为初始搜索文本,将当前选择用作初始搜索文本。

选择使用最接近的词语作为初始搜索文本,使用最接近光标位置的词语作为初始搜索文本。

搜索历史记录

选择在会话之间保留搜索和替换历史记录,以跨会话保存搜索和替换历史记录以及“查找和替换”对话框状态。清除在会话之间保留搜索和替换历史记录,以禁止保存任何搜索和替换数据,包括“查找和替换”对话框状态。

位置

选择将对话框置于文档之上,在对话框打开时将“查找和替换”对话框放置在文档上方新增的空间。当“查找和替换”对话框关闭时,该空间将被删除。这一个新增空间旨在防止对话框打开时覆盖部分文档。

编辑器/调试器缩进预设项

您可以在 MATLAB Online 编辑器和实时编辑器中更改制表符和缩进的大小,以及自动缩进的行为方式。要启用或禁用自动缩进,请参阅编辑器/调试器语言预设项

主页选项卡的环境部分,点击 预设。选择编辑器/调试器 > 缩进,然后按下表所述调整预设项选项。

缩进预设项在 MATLAB 的安装版本中不可用。

选项用法
制表符和缩进

指定制表符大小,以确定在您按 Tab 键时插入的空位量。

在更改制表符大小值时,将更改该文件中现有行的制表符大小,除非您同时选择 Tab 键插入空位

指定自动缩进的缩进大小

选择按 Tab 键插入空格可在您按下 Tab 键时插入一系列空位。否则,一个制表符充当一个空位,其长度等于制表符大小

选择按 Tab 键应用智能缩进,以在您将光标置于一行中或选择一组行后按 Tab 键时,根据自动缩进预设项自动进行缩放。

如果您选择此预设项,无法在行中插入制表符。

智能缩进选择整个文档应用智能缩进格式,以在 MATLAB Online 编辑器和实时编辑器中自动缩进时将缩进应用于整个文档。清除此选项后,将仅缩进当前行或所选内容。
选择向空行添加空白,以在 MATLAB Online 编辑器和实时编辑器中自动缩进空行时向这些行添加空白。清除此选项后,将仅缩进非空行。
选择删除键入时自动插入的空白,以删除在 MATLAB Online 编辑器和实时编辑器中键入时自动缩进时添加的空白。清除此选项后,将保留添加的空白。

编辑器/调试器保存预设项

您可以指定 MATLAB Online 是否以及何时自动保存文件。

主页选项卡的环境部分,点击 预设。选择编辑器/调试器 > 保存,然后按下表所述调整预设选项。

保存预设项在已安装的 MATLAB 版本中不可用。

预设项用法

自动保存选项

选择定期保存文件以让 MATLAB Online 定期保存您当前正在编辑的文件。

备份保存间隔: n 分钟字段中,指定您要 MATLAB 保存您正在编辑的文件的频率。默认情况下,MATLAB 每 1 分钟保存一次文件。

如果希望编辑器或实时编辑器在您点击离开文件时自动保存对文件所做的更改,请选中在文件外点击时保存更改。要在点击离开时自动保存更改,您必须已经至少保存过一次该文件。

在 MATLAB 的已安装版本中,此预设项位于 MATLAB > 编辑器/调试器下。