---
title: Unity 编程最佳实践
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/optimization/programming-best-practices
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/scripting/optimization/programming-best-practices.md
generated_at: 2026-11-16T11:29:06.244Z
locale: zh-cn
---

# Unity 编程最佳实践

> 为 Unity Applications程序编写代码When需要注意的Key问题，以及有助于避免常见陷阱的最佳实践。

与标准 C#/.NET Projects相比，Unity 编程Environment的一些独特Features在编写代码When需要额外考虑。以下是为 Unity Applications程序编写代码When需要注意的Key问题摘要，以及有助于避免常见陷阱的最佳实践。

## Unity 对象 Lifecycle 和引用##unity-object-lifecycle-and-references

在 Unity 中编写 C# When，在比较对象与Other对象或 null 的相等性When小心。对于从 [UnityEngine.Object](/engine/6000.0/manual/scripting/object-oriented-development/fundamental-unity-types/class-object.md) Inherit 继承的类型，Unity 使用 C# [相等和不等运算符](https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/operators/equality-operators)的自定义版本。这意味着 null 检查`myGameObject == null`可以评估`true`（反之亦然，`myGameObject != null`可以评估`false`），即使`myGameObject`在技术上持有有效的 C# Object 引用也是如此。ON此行为细节的更多信息，请参阅[自定义等式运算符](/engine/6000.0/manual/scripting/object-oriented-development/fundamental-unity-types/class-object.md#custom-equality-comparers)。

Unity 的自定义义相等行为和ObjectLifecycle对代码有一些影响：

* 如果要确保在检查中排除已销毁的对象，请确保对 Unity 对象使用 `if (obj == null)` 而不是 `ReferenceEquals`。
* 如果要检查实际 C# null 引用，请先使用 `ReferenceEquals` 或转换为 `System.Object`。
* 比较两个 Unity 对象的相等性时，请注意，即使两个引用都是不同的 C# 对象，如果其中一个或两个对象已被销毁并重新创建（例如通过 [`Undo`）](/engine/6000.0/script-reference/unityeditor/undo.md)，`obj1 == obj2` 也可能返回`true`。
* 自定义定义相等运算符比标准 C# 运算符慢。这通常不是问题，但在缩放和热路径中请注意这一点。
* 不要在没有防护的情况下跨Scene缓存缓存组件，因为它们可以销毁，但保留为 C# 包装器对象，没有非托管对应对象。
* 不要在Static字段中保留对大型Assets的引用用，因为它们会跨场场景持续存在并阻止卸载。
* 销毁对象时， [`Object.DestroyImmediate`](/engine/6000.0/script-reference/unityengine/object/destroyimmediate.md) 仅限 Editor，因此在运行时使用 [`Object.Destroy`](/engine/6000.0/script-reference/unityengine/object/destroy.md) ，并允许 Unity 计划销毁。

## 避免 C# 终结器##avoid-c-finalizers

不要在运行时代码中使用 [C# 终结器](https://learn.microsoft.com/en-us/dotnet/csharp/programming-guide/classes-and-structs/finalizers)，原因如下：

* ON 单独的终结器线程运行，Unity API 通常需要主要线程。
* 它们以不确定方式运行，导致不可预测的行为。
* 除非应用程序程序垃圾收集并等待，否则它们可能All无法运行。
* 除非经过特殊处理，否则从终结器抛出的异常可能会导致应用程序停止。
* 它们的存在本身会增加垃圾回收器的开销。

## 垃圾回收器开销和分配##garbage-collector-overhead-and-allocations

Unity Applications 中需要注意的最重要的性能风险之一是分配内存并增加垃圾回收器开销的运行时代码，尤其是在热路径中。

为避免这种情况，Apply 采用以下编码做法：

* 通过[缓存和重用列表](/engine/6000.0/manual/scripting/optimization/performance-optimizing-code-managed-memory/reusable-code.md)以及使用非分配版本的方法（如果可用），避免按帧分配。这包括使用[协程](/engine/6000.0/manual/scripting/object-oriented-development/coroutines-section/coroutines.md)时缓存[`WaitForSeconds`](/engine/6000.0/script-reference/unityengine/waitforseconds.md)和其他[产量指令](/engine/6000.0/script-reference/unityengine/yieldinstruction.md)。
* 尽可能使用非分配版本的方法，并执行[`Awake`](/engine/6000.0/script-reference/unityengine/monobehaviour/awake.md)[`GameObject.GetComponent`](/engine/6000.0/script-reference/unityengine/gameobject/getcomponent.md)和对返回对象的缓存引用等高成本操作，而不是从[`Update`](/engine/6000.0/script-reference/unityengine/monobehaviour/update.md)中反复调用。
* 避免在运行时代码中使用 [LINQ](https://learn.microsoft.com/en-us/dotnet/csharp/linq/)，尤其是在每帧`Update`或`FixedUpdate`和其他热路径的上下文中。`System.Linq`命名空间中的方法可能会创建不必要的分配并涉及装箱和封闭。
* 避免连接等[重复字符串操作](/engine/6000.0/manual/scripting/optimization/performance-optimizing-code-managed-memory/reference-types.md)。
* 识别和避免反射实例。有关更多信息，请参阅[避免 C# 反射开销](/engine/6000.0/manual/analysis/performance-memory/managed-memory/gc-avoid-reflection.md)。

有关这些问题的更多 Detailed 指导和示例，请参阅[优化托管内存](/engine/6000.0/manual/scripting/optimization/performance-optimizing-code-managed-memory.md)代码。

有关 ON 跟踪和减少垃圾回收器开销的信息，请参阅[托管内存](/engine/6000.0/manual/analysis/performance-memory/managed-memory.md)。

## MonoBehaviour 更新 Loop优化##monobehaviour-update-loop-optimization

许多 Unity 项目的传统模式涉及使用 MonoBehaviour 脚本组件通过内置回调（例如通常每秒运行多次的[`MonoBehaviour.Update`](/engine/6000.0/script-reference/unityengine/monobehaviour/update.md)、[`MonoBehaviour.FixedUpdate`](/engine/6000.0/script-reference/unityengine/monobehaviour/fixedupdate.md)和[`MonoBehaviour.LateUpdate`）](/engine/6000.0/script-reference/unityengine/monobehaviour/lateupdate.md)定期更新游戏状态。

这是一种Simple模型，在适当使用When仍然可以正常工作，但它有一些Key的性能风险，通常将缺乏经验的开发者挡在门外：

* Unity 的帧或Other常规事件函数的默认实现可能缩放不良。每个`Update`函数都会从 Unity 的内部管理和与原生图层的交互中产生少量开销。When有许多此类 MonoBehaviour 脚本时，累积开销可能会性能产生重大影响。
* 内置更新经常运行这一事实使它们成为热代码路径，并会放大放置在其中的Any低效、内存集型操作的特效。缺乏经验的 Users 的一种常见不良模式是有许多 MonoBehaviour 脚本带有`Update`函数，这些函数在大部分时间都不必要地运行，或者在运行时内存消耗过多。

要降低这些风险，请考虑以下选项：

* 请考虑使用 Unity 的[实体组件系统 (ECS)](https://docs.unity3d.com/Packages/com.unity.entities@latest) 将 Project 转换为面向数据的架构，以便在许多实体之间实现更好的可扩展性。

* 如果使用基于 MonoBehaviour 的架构：

  * 为确保最大限度减少热路径中的托管内存影响，请参阅[优化托管内存](/engine/6000.0/manual/scripting/optimization/performance-optimizing-code-managed-memory.md)代码。
  * 通过使用集中式更新管理员或自定义 Player Loop 来最大限度减少 Active `Update` 函数的数量。有关更多信息，请参阅[使用自定义更新管理](/engine/6000.0/manual/scripting/object-oriented-development/managing-update-order/events-per-frame-optimization.md)器和[自定义 Player Loop](/engine/6000.0/manual/scripting/object-oriented-development/managing-update-order/player-loop-customizing.md)。
  * 请注意，即使在基于 MonoBehaviour 的项目中，通常也可以使用 Unity 面向数据的系统的指定功能。您可以使用[作业](/engine/6000.0/manual/scripting/optimization/job-system.md)、代码的[爆发编译](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/burst.md)部分、在代码的性能关键部分使用更有效的数据结构（如 [`NativeArray`](/engine/6000.0/script-reference/unity/collections/nativearray1.md)）以及选择托管 API 的非托管替代方案（如[变换操作](/engine/6000.0/manual/transformhandle-landing.md)）。

## 线程安全##thread-safety

虽然 Unity 具有多线程功能，但核心运行时是单一线程的，`UnityEngine` 和 `UnityEditor` Namespaces 中的大多数 API 只能从主要线程调用。不要从背景线程引用游戏对象、变换、组件或资源 API。主线程上永远不要有`Task.Result`或`Task.Wait`的`await`，因为这会导致死锁。

当处理固有的异步和长期 running 操作时，Unity 提供 [`Awaitable`](/engine/6000.0/script-reference/unityengine/awaitable.md) 类作为 .NET `Task` 的 Unity 指定替代方案。`Awaitable` 使用 Object Pooling 来减少分配，并了解 Unity 指定的概念（如 `Update` 和 `FixedUpdate`），因此您可以`await`任务并调度它们在 Player Loop 中的指定点继续。有关更多信息，请参阅使用 Awaitable [类异步编程](/engine/6000.0/manual/scripting/optimization/async-await-support.md)。

对于生命周期较短但计算密集型更强的并行化工作，Unity 提供了可[爆发编译](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/burst.md)的[任务 System](/engine/6000.0/manual/scripting/optimization/job-system.md)。有关更多信息，请参阅使用任务系统[编写多线程代码](/engine/6000.0/manual/scripting/optimization/job-system.md)。

## 编译注意事项##compilation-considerations

要获得最佳性能，不仅要考虑代码编写方式，还要考虑代码的编译方式。以幼稚的方式编译代码，而不是主动定义代码的某些音频源文件或区域与哪些上下文相关，会产生以下成本：

* 如果包含不必要的代码，则增加版本大小。
* 编译和重新编译以 Apply 更改所花费的时间。这尤其会影响 Editor 中的迭代时间。
* 如果为给定平台或上下文包含不当代码，则潜在的运行时错误。

Unity 提供了几种机制来帮助您Control针对不同平台和上下文编译的代码部分：

* 您可以使用程序程序集定义音频源文件组到可单独编译的程序集。这允许您将仅限 Editor 的代码与运行时代码隔离，并将指定平台的代码与跨平台代码隔离。有关更多信息，请参阅将[脚本组织到程序集](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/assembly-definition-files.md)中。
* 您可以使用带有[脚本符号的](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/conditional-compilation/symbol-reference.md) `#if` 指令来根据 ON 目标平台或上下文从编译中排除指定的代码区域。例如，在 `#if UNITY_EDITOR` 指令后面保护仅限 Editor 的代码，以便将其从运行时构建中排除。ON Unity 提供的有条件包含或排除代码的各种方法的更多信息，请参阅[条件编译](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/conditional-compilation/platform-dependent-compilation.md)。
* Unity 指定的一个关键概念是在进入和退出播放模式或重新编译脚本时在 Editor 中[重新加载域](/engine/6000.0/manual/scripting/compilation-and-code-reload/code-reloading-editor/configurable-enter-play-mode.md)。在 Editor 中编写和测试When，域重新加载很耗时间，并可能会影响迭代时间。您可以ON进入播放模式禁用用域重新加载以缩短迭代时间，但随后必须手动ResetStatic状态。有关更多信息，请参阅 ON 进入播放模式的[代码和 Scene](/engine/6000.0/manual/scripting/compilation-and-code-reload/code-reloading-editor.md) 重新加载。

## Unity 的分析工具##unity's-analysis-tools

Unity 提供了各种工具来帮助识别瓶颈并编写性能更高的代码。[Project Auditor](/engine/6000.0/manual/project-auditor.md) 工具可以分析 Project 代码以确定常见的性能问题并提出修复建议。[性能分析器](/engine/6000.0/manual/analysis/profiler.md)可提供有关 CPU 和 GPU 使用情况、内存分配等的 Detailed 信息，从而帮助您识别代码中的运行时性能瓶颈。您还可以创建 [Roslyn 分析器](https://learn.microsoft.com/en-us/visualstudio/code-quality/roslyn-analyzers-overview?view=visualstudio)来强制执行编码标准并识别项目指定的性能问题。

ON创建自定义 Roslyn 分析器和音频源生成器的更多信息，请参阅 [Roslyn 分析器和音频源生成器](/engine/6000.0/manual/scripting/debugging-and-diagnostics/roslyn-analyzers.md)。

有关 ON Unity 分析工具套件的更多信息，请参阅[优化](/engine/6000.0/manual/analysis.md)。

## 其他资源##additional-resources

* [Unity 中的内存](/engine/6000.0/manual/analysis/performance-memory.md)
* [针对托管内存优化代码](/engine/6000.0/manual/scripting/optimization/performance-optimizing-code-managed-memory.md)
* [调试和诊断](/engine/6000.0/manual/scripting/debugging-and-diagnostics.md)
