---
title: Unity 链接器标记Rules参考
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/script-compilation/managed-code-stripping/marking-rules
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/marking-rules.md
generated_at: 2026-11-16T12:18:33.831Z
locale: zh-cn
---

# Unity 链接器标记Rules参考

> 了解 Unity 链接器在每个Managed剥离关卡应用的标记Rules，以确定要剥离的代码程序集的哪些部分。

Unity 链接器执行Static分析When，Rules集来确定 CIL 字节码的哪些部分作为版本的必要标记：

* [Root Marking Rules](#root-marking-rules) 确定 Unity 链接器如何识别和保留版本中的顶部关卡程序集。
* [依赖关系标记规则](#dependency-marking-rules)决定了 Unity 链接器如何识别和保留根程序集所依赖的任何代码 ON。

[Configurationd Managed 剥离关卡](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/configure.md)会更改 Unity 链接器使用的 Rules 设置。以下部分将介绍每个 Managed 剥离关卡中的标记规则。

## 根标记Rules##root-marking-rules

下表描述了 Unity 链接器如何识别程序集内不同程序集类型和 Managed 剥离级别的顶部关卡类型：

| **程序集类型**                           | **托管剥离级别的根标记规则**                                                                                                                                                                                                                                          |
| ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **.NET 类和平台 SDK 和 UnityEngine 程序集** | **最小值**和**低**：预防性保留**最小**、**低**、**中等**和**高**：Any `link.xml`文件中定义的保留                                                                                                                                                                                       |
| **具有 Scene 中引用类型的程序集**              | **最小值**和**低**：程序程序集中的All类型和成员**中等**和**高**：具有 `[RuntimeInitializeOnLoadMethod]` 或 `[Preserve]` 属性的所有方法。Any `link.xml`文件中定义的保留在预编译、包、Unity Script或程序Assembly Definition程序集内派派生 MonoBehaviour 和 ScriptableObject 的All类型。                                     |
| **所有其他**                            | **最低水平**程序程序集中的All类型和成员**低**和**中等**：All public 类型和这些类型的 public 成员**中等**和**高**：具有 `[RuntimeInitializeOnLoadMethod]` 或 `[Preserve]` 属性的所有方法。Any `link.xml`文件中定义的保留在预编译、包、Unity Script或程序Assembly Definition程序集内派派生 MonoBehaviour 和 ScriptableObject 的All类型。 |
| **测试**                              | **最小**、**低**、**中等**和**高**：具有 `[UnityTest]` 属性的任何方法和具有 NUnit.Framework 中定义的属性的任何方法。                                                                                                                                                                        |

## 依赖关系项标记Rules##dependency-marking-rules

Unity 链接器识别程序程序集的根后，需要识别这些根ON依赖的Any代码。下表描述了 Unity 链接器如何识别程序集在不同 Managed 剥离级别上的根类型的依赖关系：

| **Rule Target**      | **Managed 剥离级别的依赖关系标记规则**                                                                                                                                                                   |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **MonoBehaviour**    | **最小**、**低**、**中等**和**高**：Unity 链接器在标记 MonoBehavior 类型When标记该类型的All成员                                                                                                                       |
| **ScriptableObject** | **最小**、**低**、**中等**和**高**：Unity 链接器在标记 ScriptableObject 类型When标记该类型的All成员                                                                                                                   |
| **属性**               | **最小值**和**低**：Unity 链接器标记程序程序集、类型或Other代码结构When，也会标记这些结构的AllAttributes。**中等**和**高**：Unity 链接器标记程序程序集、类型或Other代码结构When，仅属性类型也被标记时，才会标记这些结构的Attributes。                                       |
| **调试 Attributes**    | **最小值**和**低**：启用脚本调试时，Unity 链接器会标记具有 `[DebuggerDisplay]` 属性的所有成员，即使当没有使用这些成员的代码路径时也是如此。**中等**和**高**：Unity 链接器始终删除调试Attributes，例如 `DebuggerDisplayAttribute` 和 `DebuggerTypeProxyAttribute`。 |
| **.NET Facade 类库**   | **最小**、**低**、**中等**和**高**：删除外观程序集，因为在运行时不需要它们。                                                                                                                                              |

## 其他资源##additional-resources

* [托管代码剥离和 Unity 链接器](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/unity-linker.md)
* [使用 Annotations 保留代码](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/preserving.md)
* [Link XML 格式参考](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/managed-code-stripping/xml-formatting.md)
