---
title: 程序Assembly Definition和包
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/packages-list/cus-pkg-development/cus-asmdef
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/packages-list/cus-pkg-development/cus-asmdef.md
last_updated: 2026-10-03
generated_at: 2026-11-18T10:59:17.982Z
locale: zh-cn
---

# 程序Assembly Definition和包

> Configure 程序集定义，以便 Editor 将包脚本编译为单独的程序集。

必须将包内的脚本与 Assembly Definition 文件（`.asmdef`）关联。程序Assembly Definition文件是 Unity，相当于 .NET 生态系统中的 C# Project。必须在程序Assembly Definition文件中设置对Other程序集的显式引用（无论是在同一个包还是在External包中）。请参阅[程序集定义](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/assembly-definition-files.md)以了解更多详细信息。

使用这些约定来命名和存储 Assembly Definition 文件，以确保编译的程序集文件名遵循 [.NET Framework 设计准则](https://docs.microsoft.com/en-us/dotnet/standard/design-guidelines/)：

* 将 Editor 指定的代码存储在根 Editor Assembly Definition 文件下：

  `Editor/<company-name>.<package-name>.Editor.asmdef`

* 将运行时指定的代码存储在根运行时 Assembly Definition 文件下：

  `Runtime/<company-name>.<package-name>.asmdef`

* 为Editor器和运行时时脚本Configure相关的测试程序集：

  `Tests/Editor/<company-name>.<package-name>.Editor.Tests.asmdef`

  `Tests/Runtime/<company-name>.<package-name>.Tests.asmdef`

要更一般地查看推荐的包 Folder Layout，请参阅[包 Layout](/engine/6000.0/manual/packages-list/cus-pkg-development/cus-layout.md)。

## 示例文件##example-file

在此示例中，Assembly Definition 文件使用对其自身程序集的引用，以及属于包依赖关系 ([HDRP](https://docs.unity3d.com/Packages/com.unity.render-pipelines.high-definition@latest)) 一部分的程序集：

```lang-json
{
    "name": "MyCompany.MyPackageName",
    "references": [
        "MyCompany.MyPackageName.Tools",
        "MyCompany.MyPackageName.Planes",
        "Unity.RenderPipelines.HighDefinition.Runtime"
    ],
    "includePlatforms": [],
    "excludePlatforms": [],
    "allowUnsafeCode": false,
    "overrideReferences": false,
    "precompiledReferences": [],
    "autoReferenced": true,
    "defineConstraints": [],
    "versionDefines": [
        {
            "name": "com.unity.render-pipelines.high-definition",
            "expression":"7.1.0",
            "define":"HDRP_7_1_0_OR_NEWER"
        },
        {
            "name": "com.unity.modules.particlesystem",
            "expression":"1.0.0",
            "define":"USING_PARTICLE_SYSTEM"
        }
    ],
    "noEngineReferences": false
}
```

有关 Assembly Definition 文件结构的细节，请参阅 [Assembly Definition File Format](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/assembly-definition-files/file-format.md)。

## 其他资源##additional-resources

* [程序集定义](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/assembly-definition-files.md)
