表达式错误

上次更新日期: 2026年5月5日

了解如何识别、调试和修复 Adobe After Effects 中的常见表达式错误,以便您的动画能够正确评估并按预期执行。

当表达式求值失败时,“合成”与“图层”面板底部的警告横幅会显示表达式错误。 After Effects 不禁用表达式,但继续对其进行求值。 只要表示式求值失败,就会显示警告横幅,直到修复或手动禁用表达式为止。

表达式错误 UI

下面是一个表达式错误警告横幅的示例:

表达式错误示例
表达式错误示例

A. 左箭头或右箭头按钮 B. 显示表达式 C. 展开/折叠警告 

  • 当多个表达式求值失败时,箭头或箭头按钮会显示上一个或下一个表达式错误。
  • 显示表达式(放大镜)按钮可在“时间轴”面板上显示无法计算的表达式的属性。 如果表达式位于不同的合成中,那么会打开相应的合成。
  • 展开/折叠警告(上/下箭头)按钮可显示或隐藏错误文本。

表达式错误文本只有一行,并且剪切为合成面板的宽度。

要查看完整的表达式错误文本

选择表达式旁边的 。 完整的错误将显示在一个对话框中。

表达式错误对话框
表达式错误对话框

要隐藏警告横幅

隐藏警告横幅

选择 After Effects > 设置 > 脚本和表达式 (macOS),或选择编辑 > 首选项 > 常规 (Windows),然后禁用项目包含表达式错误时显示警告横幅

禁用此选项后,即使出现新的表达式错误,也将隐藏警告横幅。

如果重新启用此选项,则可以查看表达式错误。

显示表达式错误

如果无法处理表达式,After Effects 会显示说明错误的消息并自动禁用表达式。 表达式旁边会显示一个黄色警告图标 。 选择警告图标可再次查看错误消息。

要显示具有错误的表达式,请选择一个或多个图层。 在 Windows 中右键-单击时间线面板中的所选图层,或在 macOS 中按住 Control 键并单击所选图层。 从上下文菜单中选择显示表达式错误

某些表达式依赖于项目中图层或属性的名称。 如果您更改了表达式中涉及的图层或属性名称,After Effects 会尝试更新表达式以使用新名称。 但是,在某些复杂情况下,After Effects 无法自动更新表达式。 在这种情况下,表达式可能会生成错误消息,您必须亲自更新表达式。

注释

如果您以其他语言运行 After Effects,或者更改了项(例如图层、效果或其他属性组)的名称,表达式可能无法正常工作。 要启用表达式,请修改表达式以使用与运行 After Effects 所用的语言匹配的新名称或字符串。

本文档中的示例是针对英语版 After Effects 的默认状态而创建的。 如果不做修改,本文档中的某些示例可能无效。

预合成图层导致的错误

预合成多个图层可能会导致引用其中一个图层属性的表达式生成错误。 您必须更新这些表达式,使其引用新合成中的图层。 对于使用 thisComp 而非根据其名称引用合成的表达式,要特别注意这一点。 

注释

After Effects 中某些效果的参数已在以前版本中的参数的基础上进行了更改。 如果您有使用参数索引引用而不是参数名称的现有表达式,则需要更新表达式才能使用参数名称。

更多表达式资源

当您领会了表达式背后的一些概念之后,请前往社区观看一些真实案例并分享您的作品。

AE Enhancer 论坛也提供了有关表达式、脚本和动画预设的许多示例和大量信息。