---
title: 进入播放模式并禁用域重新加载
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/compilation-and-code-reload/code-reloading-editor/domain-reloading
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/scripting/compilation-and-code-reload/code-reloading-editor/domain-reloading.md
generated_at: 2026-11-16T08:11:39.011Z
locale: zh-cn
---

# 进入播放模式并禁用域重新加载

> 了解ON进入运行播放模式时禁用域重新加载如何影响应用程序程序状态，以及如何在代码中弥补这些效果。

脚本域也称为[应用程序域](https://learn.microsoft.com/en-us/dotnet/framework/app-domains/application-domains)，简称域，是 Unity Managed 脚本 Environment 的核心功能。域是专用于特定应用程序的孤立内存部分，其中包含应用程序所需的编译类型，这些类型分组为称为[程序集](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/assembly-definition-files.md)的逻辑单位。它还包含表示当前应用程序状态的数据，例如变量的值和[托管内存](/engine/6000.0/manual/analysis/performance-memory/managed-memory.md)各个部分中的Object引用。

默认情况下，Unity 会ON进入播放模式时重新加载域以Reset应用程序程序状态。在进入播放模式之前重置状态通常是可取的，因此应用程序程序会像在版本开始时一样启动。例如，在上一个播放模式会话中递增的Static计数器应在Next一个会话中再次从零开始。但是，当经常在编辑和播放模式之间切换时，域重新加载也是一种耗时的操作，会对迭代时间产生负面影响。为了加快迭代时间，您可以 ON 进入播放模式[禁用域重新加载](/engine/6000.0/manual/scripting/compilation-and-code-reload/code-reloading-editor/configurable-enter-play-mode.md#configure-play-mode)，但随后必须在代码中手动[重置状态](#reset-state)。

> **Note:**
>
> Unity 在检测到脚本更改When，还会在资源数据库Refresh过程中执行域重新加载。即使ON进入播放模式Disabledsabled用域重新加载，也仍然会发生这种情况。有关 When and how to happen the resource database refresh（资源数据库刷新发生的时间和方式）的更多信息，请参阅[刷新资源数据库](/engine/6000.0/manual/assets-and-media/asset-database/refreshing.md)。

## 进入播放模式When用域重新加载的特效##effects-of-disabling-domain-reload-when-entering-play-mode

禁用域重新加载When：

* 非序列化字段在返回到编辑模式时保持播放模式期间分配给它们的值。这适用于所有脚本类型的字段，包括 MonoBehaviours（包括 ON 预制件 Assets）、ScriptableObjects 和您自己的自定义 C# 类型。有关在不同上下文中什么是 ON 和什么是 UN 序列化的 Detailed 信息，请参阅 [Serialization Rules](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-serialization/rules.md)。
* Static 变量在播放模式 Sessions 之间保持其值。
* Static 事件在播放模式 Sessions 之间保持其注册用户。
* 对于标有 [`[ExecuteInEditMode]`](/engine/6000.0/script-reference/unityengine/executeineditmode.md) 或 [`[ExecuteAlways]`](/engine/6000.0/script-reference/unityengine/executealways.md) 的脚本，没有其他`OnDisable`或 `OnEnable` Calls。

为了补偿播放模式 Sessions 之间的这种持久性并以新的应用程序状态进入播放模式，必须在[代码中重置状态](#reset-state)。

ON 禁用域和重新加载 Scene 的效果的更多信息，请参阅禁用域和重新加载 Scene 的[细节](/engine/6000.0/manual/scripting/compilation-and-code-reload/code-reloading-editor/configurable-enter-play-mode-details.md)。

## 从代码重置状态##resetting-state-from-code

当禁用域重新加载时，[Static 字段](https://learn.microsoft.com/en-us/dotnet/csharp/programming-guide/classes-and-structs/static-classes-and-static-class-members#static-members)的值和分配给 Static 事件的处理程序在播放模式运行之间持续存在。以下代码示例具有一个 Static 计数器，按下 Any keyboard Key 时会递增。该代码还注册了用于手柄 Static 事件[`EditorApplication.playModeStateChanged`](/engine/6000.0/script-reference/unityeditor/editorapplication/playmodestatechanged.md)的方法。

已启用域重新加载后，Unity 会在进入播放模式 ON 时重新初始化此代码，擦除先前播放模式运行中的状态，包括计数器值和事件处理程序的注册。禁用域重新加载后，计数器值和事件处理程序注册都将保留上次运行的结果。Next运行播放模式ON，计数器从上次运行结束时的值开始，并ON一次事件程序程方法，从而在控制台台中生成多个“Exiting 播放模式”消息。

```lang-cs
// Copy-paste this code into a MonoBehaviour script attached to a GameObject in your project.
// Run it with domain reload enabled and then with domain reload disabled and note the different behavior.

using UnityEngine;
#if UNITY_EDITOR
using UnityEditor;
#endif

public class StateResetExample :MonoBehaviour
{
    // With domain reload disabled this counter won't reset to zero on exiting Play mode
	Static 整型计数器 = 0;

	void Start()
    {
    // Register handler
#if UNITY_EDITOR
        EditorApplication.playModeStateChanged += OnExitPlayMode;
#endif    
    }

	void Update()
	{
    	if (Input.anyKeyDown)
        {
            counter++;
            Debug.Log("Counter: " + counter);
        }
	}
#if UNITY_EDITOR
	private static void OnExitPlayMode(PlayModeStateChange 状态)
    {
        if(state == PlayModeStateChange.ExitingPlayMode)
        {
		    // With domain reload disabled this message prints multiple times after the first Play mode run
            Debug.Log("Exiting Play mode!");
        }
    }
#endif
}
```

您可以使用在播放模式运行之间显式重置计数器和取消注册事件处理程序的代码来修复问题行为。您可以 ON 进入播放模式或 ON 退出播放模式。

### ON 退出播放模式重置状态##resetting-state-on-exiting-play-mode

ON退出播放模式时Reset状态通常最有效，而不是ON进入时重置状态。您可以使用 [`EditorApplication.playModeStateChanged`](/engine/6000.0/script-reference/unityeditor/editorapplication/playmodestatechanged.md) 事件及其[`ExitingPlayMode`](/engine/6000.0/script-reference/unityeditor/playmodestatechange/exitingplaymode.md) enum 值捕获播放模式退出事件并在该点重置状态。在以下示例中，用于播放模式退出的事件处理程序用于自行取消注册，但此时也可以使用此方法取消注册 Any Other Static 事件处理程序：

```lang-cs
using UnityEngine;
#if UNITY_EDITOR
using UnityEditor;
#endif

public class StateResetOnExit :MonoBehaviour
{
	Static 整型计数器 = 0;

	void Start()
    {
#if UNITY_EDITOR
        EditorApplication.playModeStateChanged += OnExitPlayMode;
#endif        
    }

	// Update is called once per frame
	void Update()
	{
    	if (Input.anyKeyDown)
        {
            counter++;
            Debug.Log("Counter: " + counter);
        }
	}

#if UNITY_EDITOR
	private static void OnExitPlayMode(PlayModeStateChange 状态)
    {
        if(state == PlayModeStateChange.ExitingPlayMode)
        {
            Debug.Log("Exiting Play mode!");
			Debug.Log("Unregistering handler.");
			// Unregister the handler so it doesn't affect the next Play mode run
            EditorApplication.playModeStateChanged -= OnExitPlayMode;
            Debug.Log("Resetting counter.");
			// Reset the counter so it starts from 0 on the next Play mode run
            counter = 0;
        }
    }
#endif
}
```

[`EditorApplication.playModeStateChanged`](/engine/6000.0/script-reference/unityeditor/editorapplication/playmodestatechanged.md) 位于 `UnityEditor` 命名空间中，因此，在 Unity Editor 中的播放模式，而不是桌面版本，台式机，只能运行。

如果代码在播放模式之外以编辑模式执行，则退出播放模式ON不能依赖ON重置状态。代码在编辑模式下可能会修改 Static 变量，因此[在进入播放模式](#reset-on-enter)时必须重置该变量。

> **Note:**
>
> 对于在编辑模式下执行的脚本，禁用域重新加载会跳过[`MonoBehaviour.OnDisable`](/engine/6000.0/script-reference/unityengine/monobehaviour/ondisable.md)，禁用 Scene 重新加载会跳过[`MonoBehaviour.OnDestroy`](/engine/6000.0/script-reference/unityengine/monobehaviour/ondestroy.md)，这使得这些方法不适合在这些脚本中重置状态。有关更多信息，请参阅[禁用域和场景重新加载的细节](/engine/6000.0/manual/scripting/compilation-and-code-reload/code-reloading-editor/configurable-enter-play-mode-details.md)。

### 进入播放模式时重置 ON 状态##resetting-state-on-entering-play-mode

还可以ON进入播放模式时Reset状态。如果在捕获退出的播放模式事件时遇到 Any Platform 指定的问题，或者如果您的代码也在编辑模式下执行，这可能会是一个有用的替代方法。以下示例演示了ON进入播放模式时重置Static变量和取消注册Static事件处理程序。最佳做法是始终[在退出播放模式](#reset-on-exit)时取消注册 Static 事件处理程序。等到Next一个播放模式会话时，可能会导致Object引用问题，从而导致取消处理程序错误的处理程序。

Unity 在 `UnityEngine` 和 `UnityEditor` Namespaces 中都有自定义初始化Attributes，您可以使用它们执行初始化工作，包括用户手册状态重置。应该使用哪些Attributes取决ON代码是在编辑模式还是播放模式。要重置 Player（运行时）脚本进入播放模式的 ON 状态，可将 [`[RuntimeInitializeOnLoadMethod]`](/engine/6000.0/script-reference/unityengine/runtimeinitializeonloadmethodattribute.md) 属性与 [`RuntimeInitializeLoadType.SubsystemRegistration`](/engine/6000.0/script-reference/unityengine/runtimeinitializeloadtype/subsystemregistration.md) 参数结合使用：

```lang-cs
using UnityEngine;
#if UNITY_EDITOR
using UnityEditor;
#endif

public class StateResetOnEnter :MonoBehaviour
{
	Static 整型计数器 = 0;

    [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
	Static void Init()
	{
        Debug.Log("Unregistering handler.");
		// Unregister the handler so it doesn't affect the next Play mode run
        EditorApplication.playModeStateChanged -= OnExitPlayMode;
        Debug.Log("Resetting counter.");
		// Reset the counter so it starts from 0 on the next Play mode run
        counter = 0;  
	}

	void Start()
    {
#if UNITY_EDITOR
        EditorApplication.playModeStateChanged += OnExitPlayMode;
#endif
    }

	// Update is called once per frame
	void Update()
	{
    	if (Input.anyKeyDown)
        {
            counter++;
            Debug.Log("Counter: " + counter);
        }
	}
#if UNITY_EDITOR
	private static void OnExitPlayMode(PlayModeStateChange 状态)
    {
        if(state == PlayModeStateChange.ExitingPlayMode)
        {
            Debug.Log("Exiting Play mode!");
        }
    }
#endif
}
```

[`[RuntimeInitializeOnLoadMethod]`](/engine/6000.0/script-reference/unityengine/runtimeinitializeonloadmethodattribute.md) 位于 `UnityEngine` 命名空间中，因此仅在播放模式下可用。对于仅限 Editor 的脚本，例如使用静态的自定义 Editor Windows 或 Inspector，您可以执行以下操作之一：

* 使用 [`[InitializeOnLoadAttribute]`](/engine/6000.0/script-reference/unityeditor/initializeonloadattribute.md) 为[`EditorApplication.playModeStateChanged`](/engine/6000.0/script-reference/unityeditor/editorapplication/playmodestatechanged.md)注册处理程序，然后在进入或退出播放模式时 ON 执行状态清理。请参阅[`EditorApplication.playModeStateChanged`](/engine/6000.0/script-reference/unityeditor/editorapplication/playmodestatechanged.md) API 参考以查看示例。
* 使用 [`[InitializeOnEnterPlayMode]`](/engine/6000.0/script-reference/unityeditor/initializeonenterplaymodeattribute.md) 属性可以专门 ON 进入播放模式执行清理。

> **Note:**
>
> 虽然前面的代码示例使用 MonoBehaviour 类，但您也可以在任何类型的脚本（包括 Inherit from ScriptableObject 或您自己的自定义 C# 类型）上使用这些初始化 Attributes。

## 其他资源##additional-resources

* [项目设置窗口](/engine/6000.0/manual/unity-editor/editor-settings-reference/comp-manager-group.md)
* [Editor 项目设置](/engine/6000.0/manual/unity-editor/editor-settings-reference/comp-manager-group/class-editor-manager.md)
* [工具栏](/engine/6000.0/manual/unity-editor/editor-navigating-managing/toolbar.md)
* [场景重新加载](/engine/6000.0/manual/scripting/compilation-and-code-reload/code-reloading-editor/scene-reloading.md)
* [可配置进入播放模式](/engine/6000.0/manual/scripting/compilation-and-code-reload/code-reloading-editor/configurable-enter-play-mode.md)
