---
title: 事件函数执行 Order
product: Unity Editor
version: '6000.0'
latest_version: '7000.0'
status: This page documents version 6000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/zh-cn/engine/6000.0/manual/scripting/object-oriented-development/managing-update-order/execution-order
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/scripting/object-oriented-development/managing-update-order/execution-order.md
generated_at: 2026-11-16T07:03:25.830Z
locale: zh-cn
---

# 事件函数执行 Order

> 了解 Unity 内置事件函数的执行 Order，以便可以响应事件并以正确的 Order 更新游戏状态。

下图提供了 MonoBehaviour 脚本组件生命周期内运行的事件函数的执行顺序的高级关卡 Overview。为便于阅读，图表的作用域仅限于脚本Lifecycle的Key部分，并为上下文提供了一些额外的内部部子系统更新。完整的播放PlayerLoop是针对指定的系统和子系统的更长和更复杂的更新序列，这些系统和子系统以定义的默认OrderOther运行。要检索完整的 Player Loop 及其所有系统，可以使用 [PlayerLoop API](/engine/6000.0/script-reference/unityengine/lowlevel/playerloop.md)。您还可以使用此 API 通过删除系统、添加您自己的系统以及更改更新 Order 来[自定义 Player Loop](/engine/6000.0/manual/scripting/object-oriented-development/managing-update-order/player-loop-customizing.md) 序列。

ON每个回调的含义和限制的更多信息，请参阅 [MonoBehaviour](/engine/6000.0/script-reference/unityengine/monobehaviour.md) API 参考的**消息**部分。


**Order of execution for event functions during the lifecycle of a MonoBehaviour script.:**
![](/api/media?file=/engine/6000.0/media/images/monobehaviour_flowchart.svg)

## Scene 加载和卸载之前##before-scene-load-and-unload

上图中未显示[`SceneManager.sceneLoaded`](/engine/6000.0/script-reference/unityengine/scenemanagement/scenemanager/sceneloaded.md)和[`SceneManager.sceneUnloaded`](/engine/6000.0/script-reference/unityengine/scenemanagement/scenemanager/sceneunloaded.md)事件，允许分别在加载和卸载 Scene 时接收回调。Unity 在`OnEnable`之后但在对 Scene 中的所有对象进行`Start`之前引发 `sceneLoaded` 事件。有关细节信息和用法示例，请参阅相关的 API 参考页面。

有关在执行流程中包含 Scene 加载的图表，请参阅禁用 Domain 和 Scene 重新加载的[细节](/engine/6000.0/manual/scripting/compilation-and-code-reload/code-reloading-editor/configurable-enter-play-mode-details.md)

## ON Editor 启动时运行代码##run-code-on-editor-launch

有时，make代码的某些部分ON Unity Editor 启动时或运行时时立即运行，无需Any额外的用户Action，也无需将代码作为 MonoBehaviour 脚本的一部分，可能会很有用。您可以将 [`[InitializeOnLoad]`](/engine/6000.0/script-reference/unityeditor/initializeonloadattribute.md) 属性应用于具有 [Static 构造函数](https://learn.microsoft.com/en-us/dotnet/csharp/programming-guide/classes-and-structs/static-constructors)的类，从而在 Editor 启动时运行代码，而无需任何用户 Action。或者，可将 [`[InitializeOnLoadMethod]`](/engine/6000.0/script-reference/unityeditor/initializeonloadmethodattribute.md) 属性应用于各个方法。有关更多信息和使用示例，请参阅这些Attributes的 API 引用。

## 运行时时初始化ON运行代码##run-code-on-runtime-intialization

您可以通过将[`[RuntimeInitializeOnLoadMethodAttribute]`](/engine/6000.0/script-reference/unityengine/runtimeinitializeonloadmethodattribute.md)应用于方法来运行运行时应用程序的 ON 初始化代码。还可以指定一个 [`RunTimeInitializeLoadType`](/engine/6000.0/script-reference/unityengine/runtimeinitializeloadtype.md) 属性参数来控制在 Player Loop 中属性代码的执行位置。有关使用此属性标记的方法的执行 Order 的更多信息，请参阅 API 参考以了解[`RuntimeInitializeOnLoadMethodAttribute`](/engine/6000.0/script-reference/unityengine/runtimeinitializeonloadmethodattribute.md)。

## 内部动画更更新##internal-animation-update

下图显示了常规动画更新 Loop 的执行 Order，并展开上图中标记为**内部动画更新**的节点：


**Order of execution for the regular Animation update loop.:**
![](/api/media?file=/engine/6000.0/media/images/animation-update-sequence.svg)

从 [MonoBehaviour](/engine/6000.0/script-reference/unityengine/monobehaviour.md) 派生的脚本调用图中所示的以下动画 Loop 回调：

* [`MonoBehaviour.OnAnimatorMove`](/engine/6000.0/script-reference/unityengine/monobehaviour/onanimatormove.md)
* [`MonoBehaviour.OnAnimatorIK`](/engine/6000.0/script-reference/unityengine/monobehaviour/onanimatorik.md)

派生自 [`StateMachineBehaviour`](/engine/6000.0/script-reference/unityengine/statemachinebehaviour.md) 的 ON 脚本调用其他与动画相关的事件函数：

* [`StateMachineBehaviour.OnStateMachineEnter`](/engine/6000.0/script-reference/unityengine/statemachinebehaviour/onstatemachineenter.md)
* [`StateMachineBehaviour.OnStateMachineExit`](/engine/6000.0/script-reference/unityengine/statemachinebehaviour/onstatemachineexit.md)
* [`StateMachineBehaviour.OnStateEnter`](/engine/6000.0/script-reference/unityengine/statemachinebehaviour/onstateenter.md)
* [`StateMachineBehaviour.OnStateUpdate`](/engine/6000.0/script-reference/unityengine/statemachinebehaviour/onstateupdate.md)
* [`StateMachineBehaviour.OnStateExit`](/engine/6000.0/script-reference/unityengine/statemachinebehaviour/onstateexit.md)
* [`StateMachineBehaviour.OnStateMove`](/engine/6000.0/script-reference/unityengine/statemachinebehaviour/onstatemove.md)
* [`StateMachineBehaviour.OnStateIK`](/engine/6000.0/script-reference/unityengine/statemachinebehaviour/onstateik.md)

图中显示的Other动画函数是动画系统的内部函数，用于上下文。这些函数具有关联的性能分析器 Markers，因此您可以使用[性能分析器](/engine/6000.0/manual/analysis/profiler.md)查看 Unity 在帧中调用它们的时间。了解 Unity WhenCalls这些函数可以帮助您准确了解所调用的事件函数的执行When。有关动画函数和性能分析器 Markers 的完整执行 Order，请参阅性能[分析器 Markers](/engine/6000.0/manual/analysis/profiler/markers.md#animation)。

## 渲染##rendering

此执行 Order 仅适用于[内置渲染管道](/engine/6000.0/manual/render-pipelines/built-in-render-pipeline.md)。有关基于[可编程渲染管线](/engine/6000.0/manual/render-pipelines/scriptable-render-pipeline-introduction.md)的渲染管线中的执行 Order 的细节，请参阅[通用渲染管道](/engine/6000.0/manual/render-pipelines/universal-render-pipeline/customizing-urp/inject-a-render-pass/custom-pass-injection-points.md)或[高清渲染管道](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest/index.html?subfolder=/manual/rendering-execution-order.html)文档的相关部分。如果要在渲染之前立即开展工作，请参阅 [Application.onBeforeRender](/engine/6000.0/script-reference/unityengine/application/onbeforerender.md)。

* [](/engine/6000.0/script-reference/unityengine/monobehaviour/onprecull.md)在 Camera 剔除 Scene 之前调用。剔除确定哪些对象对 Camera 可见。在进行剔除之前立即调用 `OnPreCull`。
* [](/engine/6000.0/script-reference/unityengine/monobehaviour/onbecamevisible.md)当对象对任何 Camera 可见/不可见时调用。上面的流程图中未显示 `OnBecameInvisible`，因为Object 可能随时变为不可见。
* [](/engine/6000.0/script-reference/unityengine/monobehaviour/onwillrenderobject.md)如果 Object 可见，则为每个 Camera 调用一**次**。
* [](/engine/6000.0/script-reference/unityengine/monobehaviour/onprerender.md)在 Camera 开始渲染 Scene 之前调用。
* [](/engine/6000.0/script-reference/unityengine/monobehaviour/onrenderobject.md)Done All 常规场景渲染完成后调用。此时可以使用 [GL](/engine/6000.0/script-reference/unityengine/gl.md) 类或[图形。DrawMeshNow](/engine/6000.0/script-reference/unityengine/graphics/drawmeshnow.md) 绘制自定义几何体。
* [](/engine/6000.0/script-reference/unityengine/monobehaviour/onpostrender.md)在 Camera 完成 Scene 渲染后调用。
* [](/engine/6000.0/script-reference/unityengine/monobehaviour/onrenderimage.md)在场景渲染完成后调用以允许对图像进行 POST 处理，请参阅[ POST 处理特效](/engine/6000.0/manual/post-processing-and-full-screen-effects/overview.md)。
* [](/engine/6000.0/script-reference/unityengine/monobehaviour/ongui.md)帧调用多个次以响应 GUI 事件。首先处理 Layout 和 Repaint 事件，然后为每个输入事件处理 Layout 和键盘/鼠标事件。
* [`OnDrawGizmos`](/engine/6000.0/script-reference/unityengine/monobehaviour/ondrawgizmos.md) 用于在“场景”视图中绘制小工具以实现可视化。

> **Note:**
>
> [OnPreCull](/engine/6000.0/script-reference/unityengine/camera/onprecull.md)、[OnPreRender](/engine/6000.0/script-reference/unityengine/camera/onprerender.md)、[OnPostRender](/engine/6000.0/script-reference/unityengine/camera/onpostrender.md) 和 [OnRenderImage](/engine/6000.0/script-reference/unityengine/camera/onrenderimage.md) 是在 MonoBehaviour 脚本上调用的内置 Unity 事件函数，但**仅当这些脚本附加到与已启用的 Camera 组件相同的对象时**。如果要接收对**不同**对象所挂的 MonoBehaviour 的 `OnPreCull`、`OnPreRender` 和 `OnPostRender` 的等效回调，则必须使用等效委托（注意名称中的小写`on`）[Camera.onPreCull](/engine/6000.0/script-reference/unityengine/camera/onprecull-1.md)、[Camera.onPreRender](/engine/6000.0/script-reference/unityengine/camera/onprerender-1.md) 和 [Camera.onPostRender](/engine/6000.0/script-reference/unityengine/camera/onpostrender-1.md)，如脚本参考相关页面的代码示例所示。

## 协程和异步任务的恢复##resumption-of-coroutines-and-asynchronous-tasks

根据使用的 yield 指令，暂停的协程可以在执行序列的不同点恢复。例如，使用[`WaitForEndOfFrame`](/engine/6000.0/script-reference/unityengine/waitforendofframe.md)的协程在帧结束时恢复，而使用[`WaitForFixedUpdate`](/engine/6000.0/script-reference/unityengine/waitforfixedupdate.md)的协程在已修复的更新步骤结束时恢复。如需了解更多信息，请参阅[协程](/engine/6000.0/manual/scripting/object-oriented-development/coroutines-section/coroutines.md)。

常规 .NET 任务和异步方法在`Update`阶段恢复。与协程类似，Unity 的自定义[`Awaitable`](/engine/6000.0/script-reference/unityengine/awaitable.md)类可以根据您在等待时使用的方法在不同点恢复。有关更多信息，请参阅使用 Awaitable [类异步编程](/engine/6000.0/manual/scripting/optimization/async-await-support.md)。

> **Note:**
>
> 不能保证恢复协程和异步任务之间的确切执行 Order。可等待项会分组到全体学员，并按其等待的 Order 执行。

## 将 MonoBehaviour 与 Entities 结合##combining-monobehaviours-with-entities

使用[实体组件系统](https://docs.unity3d.com/Packages/com.unity.entities@latest/index.html) (ECS) 时，Unity 会将 ECS System 组更新合并到 Player Update Loop 中。

您可以使用 Entities 系统 窗口View ECS System组相对于完整播放PlayerLoop的更新Order。有关更多信息，请参阅 Entities 包文档中的 [Update Order of systems](https://docs.unity3d.com/Packages/com.unity.entities@1.4/manual/systems-update-order.html#update-order-of-systems)。

## 局限性##limitations

General 中，您不能依赖于为不同游戏对象调用相同事件函数的 Order，但 When the Order is显式documented or settable 除外。

无法指定为同一 MonoBehaviour 脚本的不同实例调用事件函数的 Order。例如，一个 MonoBehaviour 的 `Update` 函数可以在另一个游戏对象（包括自己的父或子游戏对象）上的同一 MonoBehaviour 的 `Update` 函数之前或之后调用。

要在不同 MonoBehaviour 脚本之间配置执行 Order，请参阅 [Script Execution Order](/engine/6000.0/manual/scripting/object-oriented-development/managing-update-order/script-execution-order.md)。

## 其他资源##additional-resources

* [事件函数](/engine/6000.0/manual/scripting/object-oriented-development/managing-update-order/event-functions.md)
* [MonoBehaviour](/engine/6000.0/manual/scripting/object-oriented-development/fundamental-unity-types/class-mono-behaviour.md)
* [PlayerLoop API 参考](/engine/6000.0/script-reference/unityengine/lowlevel/playerloop.md)
* [Script Execution Order](/engine/6000.0/manual/scripting/object-oriented-development/managing-update-order/script-execution-order.md)
