Ae 2026 首选项：脚本和表达式

Ae菜单：编辑/首选项/脚本和表达式

Edit/Preferences/Scripting & Expressions

After Effects 首选项中的“脚本和表达式”（Scripting & Expressions）选项卡用于设置应用程序脚本的安全权限和执行提示、表达式错误提示，以及表达式编辑器的代码显示、缩进、自动完成和配色等行为。

脚本和表达式虽然都使用 JavaScript 相关语法，但用途不同：脚本（Script）用于自动操作 After Effects 和项目，表达式（Expression）则附加到属性上，用于计算属性值和建立动画关系。因此，上半部分的“应用程序脚本”设置主要影响 .jsx 等脚本，下面的“表达式”和“表达式编辑器”设置主要影响时间轴中的表达式。

图中的复选框状态、数值、下拉选项和颜色均为当前默认设置。

应用程序脚本

Application Scripting

用于控制 After Effects 脚本的文件与网络访问权限、脚本调试、执行警告和进度显示。

允许脚本写入文件和访问网络

Allow Scripts to Write Files and Access Network

默认不勾选。

勾选后，After Effects 脚本可以向本地文件写入数据，并通过网络进行通信。某些需要保存配置文件、生成外部文件、连接网络服务或与其他程序交换数据的脚本必须启用此权限才能完整工作。

取消勾选后，脚本仍然可以执行许多 After Effects 内部操作，例如创建合成、修改图层或调整属性，但受到文件写入和网络访问限制。

由于脚本获得这些权限后可以操作计算机上的文件或与网络通信，因此只应在使用可信脚本并确实需要这些功能时勾选。普通用户如果没有相关脚本需求，保持默认不勾选即可。

启用 JavaScript 调试器

Enable JavaScript Debugger

默认不勾选。

勾选后，允许对 After Effects 的 ExtendScript（.jsx）脚本进行 JavaScript 调试；脚本执行过程中出现相应错误时，可以调用调试功能帮助定位问题。

该设置主要面向脚本开发者，普通使用脚本的用户通常不需要开启。

执行文件时警告用户

Warn User When Executing Files

默认勾选。

英文原意是：使用“文件/脚本/运行脚本文件”命令执行脚本文件时显示警告，而不是打开任意普通文件时都发出警告。

保持勾选可以在手动执行外部脚本前提供一次安全提示，尤其适合来源不明或尚未检查过的脚本。

取消勾选后，使用“运行脚本文件”执行脚本时不再显示这项警告。

显示脚本进度对话框

Show Scripting Progress Dialog

默认勾选。

勾选后，脚本运行时可以显示模态进度对话框，其中包含进度条以及从脚本开始执行以来的时间，便于判断耗时较长的脚本是否仍在运行。

由于这是模态对话框，显示期间通常需要等待当前脚本操作完成后才能继续正常操作 After Effects。

取消勾选后，不显示这类脚本执行进度对话框。对于执行时间很短、频繁调用且不需要查看进度的脚本，可以根据需要关闭。

表达式

Expressions

用于控制表达式拾取器生成代码的形式，以及项目出现表达式错误时是否显示警告。

以简明英语编写表达式拾取

Expression Pick Whip Writes Compact English

默认勾选。

英文原意为：表达式拾取器使用简明英语格式写入表达式。

勾选后，使用表达式拾取器连接属性时，After Effects 会尽量生成简洁、基于内置英文属性名称的表达式。例如：

thisComp.layer("Layer 1").transform.position

取消勾选后，同样的引用可能采用较完整的属性访问形式，例如：

thisComp.layer("Layer 1")("Transform")("Position")

默认使用 Compact English 的一个重要作用是提高表达式在不同语言版本 After Effects 之间的兼容性。内置属性可以使用统一的英文名称进行引用，而用户可以自行修改的图层名等名称仍保留在引号中。

因此，尤其是在需要与不同语言版本的 After Effects 交换项目时，通常应保持默认勾选。

当项目包含表达式错误时显示警告横幅

Show Warning Banner When Project Contains Expression Errors

默认勾选。

勾选后，当项目中的表达式无法正确计算时，“合成”或“图层”面板底部会显示表达式错误警告横幅，提示项目中存在错误。

取消勾选后，即使出现新的表达式错误，也不会显示该警告横幅，但表达式本身的错误并不会因此消失。

通常建议保持勾选，以便及时发现表达式引用失效、名称修改、语法错误或其他计算问题。

表达式编辑器

Expression Editor

用于设置时间轴中表达式编辑器的字体、语法突出显示、行号、代码折叠、自动换行、缩进、错误提示、自动完成和配色等编辑功能。

这些选项主要改变表达式代码的编辑和显示方式，不会改变表达式本身的计算结果。

字体大小

Font Size

默认值为 12。

设置表达式编辑器中的代码字体大小，可设置为 8～24。数值越大，代码越容易阅读，但同一编辑区域能够显示的内容越少。

语法突出显示

Syntax Highlighting

默认勾选。

勾选后，根据代码元素的类型使用不同颜色显示关键字、标识符、注释、数字、字符串和运算符等内容，使表达式结构更容易识别。

取消勾选后，不再按照语法类型分别着色。

具体颜色可以通过下方“主题”和颜色设置进行调整。

显示行号

Show Line Numbers

默认勾选。

勾选后，在表达式编辑器左侧显示代码行号。

当表达式较长或者错误信息指出具体行号时，行号可以帮助快速定位相应代码。取消勾选后隐藏行号，为代码区域留下更多横向空间。

显示缩进标尺

Show Indent Guides

默认不勾选。

勾选后，在代码缩进层级之间显示垂直辅助线，帮助观察 if、while、函数和其他嵌套代码块的层级关系。

对于较短的表达式通常没有必要；编写多层嵌套代码时可以开启。

下方的“缩进指示”颜色用于控制这些辅助线的显示颜色。

突出显示匹配的大括号

Highlight Matching Braces

默认勾选。

勾选后，当光标位于括号附近时，编辑器会突出显示与其配对的括号，包括相应的大括号、方括号和圆括号，便于检查代码结构是否正确。

下方的“正确的大括号”和“错误的大括号”颜色分别用于提示正确匹配和存在问题的括号。

自动插入括号

Auto Insert Braces

默认勾选。

勾选后，输入左侧括号时，编辑器可以自动补充相应的右侧括号，例如输入 (、[ 或 { 时自动生成配对符号。

这可以减少漏写闭合括号造成的语法错误。

自动缩进大括号

Auto Indent Braces

默认勾选。

勾选后，在大括号形成的代码块中输入新代码时，编辑器自动按照代码层级进行缩进，使嵌套关系更加清晰。

取消勾选后，需要自行控制相应的代码缩进。

回车取消缩进

Backspace Unindents

英文原意为“退格键取消缩进”。

默认勾选。

勾选后，当光标位于已经缩进的空白位置时，按 Backspace 键可以一次取消一个缩进层级，而不是逐个删除前面的空格。

内联错误

Inline Errors

默认勾选。

勾选后，表达式中的错误可以直接在代码编辑区域中显示，例如在出错位置显示标记和错误信息，而不必只依靠合成面板中的表达式警告横幅。

这与前面的“当项目包含表达式错误时显示警告横幅”并不相同：前者是在表达式编辑器内部定位具体错误，后者是在查看器中提醒整个项目存在表达式错误。

编写和调试表达式时通常应保持勾选。

自动完成

Auto Complete

默认勾选。

勾选后，输入表达式时会提供自动完成建议，包括常用属性、方法以及当前项目中的合成名、图层名、素材名和效果名等。

例如，在输入图层或效果引用时，可以直接从建议列表中选择名称，减少完整手动输入造成的拼写错误。

取消勾选后，不再自动显示这些代码建议。

折叠：

Folding:

用于设置表达式编辑器中代码折叠控件的显示方式。代码折叠可以将较长的代码块临时收起，只保留主要结构，便于浏览和编辑包含条件语句、函数或多层大括号的复杂表达式。

--关闭

Off

关闭代码折叠功能。

选择后，表达式编辑器左侧不显示代码折叠控件，也不能通过折叠按钮临时收起代码块。它不会修改表达式本身，只是关闭编辑器中的折叠显示功能。

--箭头

Arrow

使用箭头图标表示可以折叠的代码块。

代码块展开和折叠时，箭头方向会相应变化。点击箭头即可收起或重新展开对应的代码区域。这种样式比较简洁，不显示明显的树状层级连接线。

--加号和减号

Plus & Minus

使用加号和减号作为代码折叠控件。

展开的代码块以减号表示，点击后将代码块折叠；折叠后的区域以加号表示，点击可重新展开。

这种方式与许多代码编辑器和树形目录中的展开/折叠控件相似，状态比较直观。

--圆形树状图

Circle Tree

使用圆形节点和树状连接线显示代码折叠结构。

编辑器左侧不仅显示可展开或折叠的节点，还通过纵向连接线表现嵌套代码块之间的层级关系。对于包含多层 if、for、函数或其他大括号结构的较长表达式，可以更直观地观察代码层级。

--方框树状图

Square Tree

默认选项。

使用方形节点和树状连接线显示可折叠代码区域。编辑器左侧会出现相应的展开/折叠控件，同时以连接线显示代码块的嵌套关系，可以将大括号包含的代码块收起或展开。

它与“Circle Tree”的主要区别在于折叠节点的视觉样式：前者使用圆形节点，这一选项使用方形节点；代码折叠功能本身没有本质区别。

代码折叠只改变表达式编辑器中的显示状态，不会删除或注释被折叠的代码，也不会影响表达式的计算结果。

自动换行：

Word Wrap:

用于设置较长代码行超过表达式编辑器可用宽度时的视觉换行方式。Adobe 将其分为关闭自动换行、按单词边界换行和按字符边界换行三种模式。

--无

None

关闭自动换行。

代码行超过当前编辑区域宽度后仍保持为一行，不会自动折到下一显示行。查看较长表达式时需要横向查看超出可视区域的内容。

这种方式能够保持每一条实际代码行的视觉完整性，适合希望严格区分真实换行与编辑器视觉换行的用户。

--单词

Word

默认选项。

代码超过当前编辑区域宽度时，优先在单词、空格或适合的语法元素边界处换行，尽量避免把一个完整单词或代码标识符从中间拆开。

对于大多数表达式，这是可读性较好的选择，尤其适合包含较长属性路径、函数调用或注释的代码。

--字符

Character

按照字符边界进行自动换行。

当一行代码到达编辑区域右侧边界时，可以直接在当前位置附近换到下一显示行，而不必等待适合的单词边界。因此，较长的变量名、属性名称、字符串或其他连续字符也可能在视觉上被分成两行。

这种方式能够尽量避免横向滚动，但代码结构的阅读连续性通常不如“Word”。

自动换行只改变代码在表达式编辑器中的视觉显示方式，不会在表达式文本中真正插入换行符，也不会改变表达式的语法、实际行数或计算结果。

使用选项卡

Use Tabs

默认勾选。

这里的中文“选项卡”容易产生误解。英文 Tabs 指的是代码缩进使用的Tab 制表符，不是 After Effects 界面中的选项卡。

勾选后，缩进使用 Tab 字符；取消勾选后，缩进使用空格。

该设置主要影响表达式代码的排版方式，对于大多数普通表达式不会改变运行结果。

宽度

Width

默认值为 4。

设置一个 Tab 或一个缩进层级在编辑器中对应的显示宽度。当前可设置为 2～8。

该值主要影响代码的缩进显示，并不表示表达式中数值或其他内容的宽度。

主题

Theme

用于选择和设置表达式编辑器的整体配色主题。

--After Effects 经典暗色

Theme: After Effects Classic Dark

默认选项。

采用与深色 After Effects 界面相协调的代码配色。

选项还有：A Merestone、After Effects Classic Light、After Effects Green Cache、After Effects High Contrast、After Effects Pastel、Basic Dark、Basic Light、Classic、Cloak-O-Nut、Down N' Away、Grayscale Dark、Grayscale Light、Hauf Dark、Hauf Light、Labels、Low Light、Monokai、Neon、Playground、Slate、Solarized Dark、Solarized Light、Terminal、Yellow Alert、Zakal 等。

主题不仅控制背景颜色，还可以统一设置普通文本、关键字、注释、字符串、括号和选择区域等不同代码元素的颜色。

右侧的相关按钮可用于保存自定义主题或删除可删除的自定义主题。Adobe 也允许在现有主题基础上修改颜色并保存为自己的表达式编辑器主题。

默认设置

Default

设置普通表达式文本的颜色。

这里的 Default 指没有被归类到关键字、字符串、数字等专门语法类型中的默认文字颜色。

背景

Background

设置表达式编辑器的背景颜色。

行号

Line Numbers

设置左侧行号的颜色。

Keywords

设置 JavaScript 关键字的颜色，例如 if、for、while、true 和 false 等。

标识符

Identifiers

设置标识符的颜色，例如变量名以及表达式中的部分对象、属性或函数标识。

注释

Comments

设置代码注释的颜色，例如以 // 开始的单行注释。

数字

Numbers

设置数值常量的颜色，例如 10、3.5 等。

字符串

Strings

设置字符串文本的颜色，例如 "Layer 1"。

运算符

Operators

设置运算符的颜色，例如 +、-、*、/、&& 和 || 等。

缩进指示

Indent Guides

设置启用“显示缩进标尺”后，缩进辅助线使用的颜色。

截图中由于“显示缩进标尺”未勾选，因此该项目呈灰色状态。

正确的大括号

Good Brace

设置正确匹配的括号在突出显示时使用的颜色。

错误的大括号

Bad Brace

设置没有正确配对或存在错误的括号使用的警告颜色。

选择项

Selection

设置在表达式编辑器中选中文本时使用的背景颜色。

选择项 Alpha

Selection Alpha

默认值为 0.3。

设置“选择项”颜色覆盖选中文本时的不透明度。数值越高，选择区域的背景颜色越明显；数值越低，则越容易看到下面原有的语法配色。

这些颜色项目均可以通过旁边的颜色控件进行自定义。修改后可以直接在上方的代码预览区域观察效果，而不会改变表达式代码本身。

“点赞有美意，赞赏是鼓励”