程序集定义和程序集引用是可创建用于将脚本组织为程序集的资源。

程序集是 C# 代码库，其中包含由脚本定义的已编译类和结构并且还定义了对其他程序集的引用。有关 C# 中的程序集的一般信息，请参阅 [.NET 中的程序集]。

默认情况下，Unity 几乎将所有游戏脚本都编译到预定义 程序集 Assembly-CSharp.dll 中。（Unity 还会创建[一些较小的专用预定义程序集]。）

这种安排对于小型项目而言可以接受，但是在向项目添加更多代码时会有一些缺点：

通过定义程序集，可以组织代码以促进模块化和可重用性。为项目定义的程序集中的脚本不再添加到默认程序集中，并且只能访问指定的其他程序集中的脚本。

上图演示了如何将项目中的代码拆分为多个程序集。因为 Main 引用 Stuff 并且不进行反向引用，所以知道对 Main 中的代码进行的任何更改都不会影响 Stuff 中的代码。同样，因为 Library 不依赖于任何其他程序集，所以可以更轻松地在其他项目中重用 Library 中的代码。

本部分将讨论如何创建和设置程序集定义和程序集引用资源以便为项目定义程序集：

另请参阅：

要将项目代码组织成程序集，请为每个所需程序集创建一个文件夹，并将应属于每个程序集的脚本移动到相关文件夹中。然后[创建程序集定义资源]以指定程序集属性。

Unity 会获取包含程序集定义资源的文件夹中的所有脚本，并使用该资源定义的名称和其他设置将它们编译为程序集。Unity 还包含同一程序集中的任何子文件夹中的脚本，除非子文件夹具有自己的程序集定义或程序集引用资源。

要包含来自现有程序集中一个非子文件夹的脚本，请在该非子文件夹中创建一个程序集引用资源，并将它设置为引用定义目标程序集的程序集定义资源。例如，可以将来自项目中所有 Editor 文件夹的脚本合并到它们自己的程序集中，无论这些文件夹位于何处。

Unity 会按照由其依赖项确定的顺序编译程序集；无法指定进行编译的顺序。

当一种类型（如类或结构）使用另一种类型时，第一种类型依赖于 第二种类型。当 Unity 编译脚本时，它还必须可以访问该脚本所依赖的任何类型或其他代码。同样，当已编译的代码运行时，它必须可以访问其依赖项的已编译版本。如果两种类型处于不同的程序集中，则包含依赖类型的程序集必须声明对包含它所依赖类型的程序集的引用。

可以使用程序集定义的选项控制项目中使用的程序集之间的引用。程序集定义设置包括：

__注意：__使用程序集定义创建的程序集中的类不能使用预定义程序集中定义的类型。

默认情况下，预定义程序集会引用所有其他程序集，包括使用程序集定义创建的程序集 (1) 以及作为插件添加到项目中的预编译程序集 (2)。此外，使用程序集定义资源创建的程序集会自动引用所有预编译程序集 (3)：

在默认设置中，预定义程序集中的类可以使用项目中任何其他程序集定义的所有类型。同样，使用程序集定义资源创建的程序集可以使用在任何预编译（插件）程序集中定义的所有类型。

可以通过在程序集定义资源的 Inspector 中关闭 [Auto Referenced 选项]来防止预定义程序集引用某个程序集。关闭自动引用意味着在更改程序集中的代码时不会重新编译预定义程序集，但也意味着预定义程序集无法直接使用此程序集中的代码。请参阅[程序集定义 (Assembly Definition) 属性]。

同样，可以通过在插件资源的 Plugin Inspector 中关闭 [Auto Referenced 属性]来防止自动引用插件程序集。这会影响预定义程序集以及使用程序集定义创建的程序集。请参阅 Plugin Inspector 以了解更多信息。

关闭__插件__的 Auto Referenced 时，可以在 Inspector 中为程序集定义资源显式引用它。请启用该资源的 Override References 选项，然后添加对__插件__的引用。请参阅[程序集定义 (Assembly Definition) 属性]。

__注意：__无法声明预编译程序集的显式引用。预定义程序集只能使用自动引用的程序集中的代码。

当一个程序集引用第二个程序集，而第二个程序集又引用第一个程序集时，便存在循环程序集引用。程序集之间的这类循环引用是不允许的，会报告为错误并显示消息“Assembly with cyclic references detected”。

通常，程序集之间的这类循环引用是由于程序集中定义的类中的循环引用而发生的。虽然同一程序集中的类之间的循环引用在技术上没有什么无效之处，但不允许不同程序集中的类之间进行循环引用。如果遇到循环引用错误，则必须重构代码以移除循环引用或将相互引用的类置于同一程序集中。

要创建程序集定义资源，请执行以下操作：

Unity 会重新编译项目中的脚本以创建新程序集。完成后，便可以为新程序集定义更改设置。

包含程序集定义的文件夹中的脚本（包括任何子文件夹中的脚本（除非这些文件夹包含其自己的程序集定义或引用资源））会编译到新程序集中并从它们以前的程序集中移除。

要创建程序集定义引用资源，请执行以下操作：

在 Project 窗口中，找到包含要包括在引用程序集中的脚本的文件夹。

在该文件夹中创建程序集引用资源（菜单：__Assets__ > Create > __Assembly Definition Reference__）。

为资源分配名称。

Unity 会重新编译项目中的脚本以创建新程序集。完成后，便可以为新程序集定义引用更改设置。

选择新的程序集定义引用资源以在 Inspector 中查看其属性。

设置 Assembly Definition 属性以引用目标程序集定义资源。

单击 Apply。

包含程序集定义引用资源的文件夹中的脚本（包括任何子文件夹中的脚本（除非这些文件夹包含其自己的程序集定义或引用资源））会编译到引用程序集中并从它们以前的程序集中移除。

要为特定平台创建程序集，请执行以下操作：

[创建程序集定义资源]。

选择新的程序集定义引用资源以在 Inspector 中查看其属性。

选中 Any Platform 选项并选择要排除的特定平台。或者，可以取消选中 Any Platform 并选择要包含的特定平台。

单击 Apply。

为平台构建项目时，会根据选定平台包含（或排除）程序集。

通过编辑器程序集可以将编辑器脚本置于项目中的任何位置，而不仅仅是置于名为 Editor 的顶层文件夹中。

要在项目中创建包含编辑器代码的程序集，请执行以下操作：

通过测试程序集可以编写测试并使用 Unity TestRunner 运行它们，同时还使测试代码与应用程序附带的代码分开。Unity 提供 TestRunner 作为 [Test Framework 包]的一部分。请参阅 [Test Framework 文档]以了解有关安装 Test Framework 包和创建测试程序集的说明。

要使用属于另一个程序集一部分的 C# 类型和函数，必须在程序集定义资源中创建对该程序集的引用。

要创建程序集引用，请执行以下操作：

选择需要引用的程序集的程序集定义以在 Inspector 中查看其属性。

在 Assembly Definition References 部分中，单击 + 按钮以添加新引用。

将程序集定义资源分配给引用列表中新创建的字段。

通过启用 Use GUIDs 选项可以更改引用程序集定义资源的文件名，而无需更新其他程序集定义中的引用以反映新名称。（请注意，如果删除了资源文件的元数据文件，或者将文件移到 Unity 编辑器之外，而没有同时随它们移动元数据文件，则必须重置 GUID。）

默认情况下，项目中使用程序集定义创建的所有程序集都会自动引用所有预编译程序集。这些自动引用意味着在更新任何一个预编译程序集时，Unity 都必须重新编译所有程序集，即使未使用程序集中的代码也是如此。要避免这种额外开销，可以覆盖自动引用并指定仅引用程序集实际使用的预编译库：

选择需要引用的程序集的程序集定义以在 Inspector 中查看其属性。

在 General 部分中，启用 Override References 选项。

选中 Override References 后，__Inspector__ 的 Assembly References 部分会成为可用状态。

在 Assembly References 部分中，单击 + 按钮以添加新引用。

使用空字段中的下拉列表分配对预编译程序集的引用。该列表会显示项目中适用于当前在项目 Build Settings 中设置的平台的所有预编译程序集。（可在 Plugin Inspector 中为预编译程序集设置平台兼容性。）

单击 Apply。

为构建项目时针对的每个平台重复操作。

可以使用预处理器符号控制程序集是否进行了编译并包含在游戏或应用程序的构建中（包括编辑器中的运行模式）。可以在程序集定义选项中通过 Define Constraints 列表指定必须为要使用的程序集定义的符号：

选择程序集的程序集定义以在 Inspector 中查看其属性。

在 Define Constraints 部分中，单击 + 按钮以将新符号添加到约束列表中。

输入符号名称。

可以通过在名称前放置感叹号来“否定”符号。例如，约束 !UNITY_WEBGL 会在未定义 UNITY_WEBGL 时包含程序集。

单击 Apply。

可以使用以下符号作为约束：

在确定是否满足约束时，不会考虑脚本中定义的符号。

有关其他信息，请参阅 Define Constraints。

If you need to compile different code in an assembly according to whether a project uses specific versions of Unity or of a package, you can add entries to the Version Defines list. This list specifies rules for when a symbol should be defined. For version numbers, you can specify a logical expression that evaluates to a specific version or a range of versions.

要有条件地定义符号，请执行以下操作：

Select the Assembly Definition asset for the assembly to view its properties in the Inspector.

在 Version Defines 部分中，单击 + 按钮以将条目添加到列表中。

设置属性：

The Expression outcome shows which versions the expression evaluates to. If the outcome displays, Invalid, then expression syntax is incorrect.

The following example defines the symbol, USE_TIMELINE_1_3, if the project uses Timeline 1.3 and defines, USE_NEW_APIS, if the project is opened in Unity 2021.2.0a7, or later:

单击 Apply。

在程序集定义中定义的符号仅在为该定义创建的程序集中的脚本范围内。

Note that you can use the symbols defined using the Version Defines list as Define Constraints. Thus you could specify that an assembly should only be used when specific versions of a given package are also installed in the project.

You can use expressions to specify an exact version or a range of versions. A Version Define expression uses mathematical range notation.

A square bracket, “[]” designates that the range includes the endpoint:

[1.3,3.4.1] 计算为 1.3.0