---
title: Layoutyout局
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-layout
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/packages-list/cus-pkg-development/cus-layout.md
last_updated: 2026-10-30
generated_at: 2026-11-18T10:57:42.623Z
locale: zh-cn
---

# Layoutyout局

> 遵循清单、Editor器和运行时时程序集、测试、样本和文档的建议Folder结构。

这是为自定义资源包建议的包 Layout：

```lang-plain
<package-root>
  ├── package.json
  ├── README.md
  ├── CHANGELOG.md
  ├── LICENSE.md
  第三方通知
  ├── Editor
  │ ├── <company-name>.<package-name>.Editor.asmdef
  │   └── EditorExample.cs
  ├──运行时
  │   ├── <company-name>.<package-name>.asmdef
  │   └── RuntimeExample.cs
  ├── 测试
  │ ├── Editor
  │ │ ├── <company-name>.<package-name>.Editor.Tests.asmdef
  │   │   └── EditorExampleTest.cs
  │ └──运行时
  │        ├── <company-name>.<package-name>.Tests.asmdef
  │        └── RuntimeExampleTest.cs
  样本~
  │        ├── SampleFolder1
  │        ├── SampleFolder2
  │        └── ...
  └── Documentation~
       └── <package-name>.md
```

许多官方 Unity 包也实现此结构。

| **位置**                   | **描述**                                                                                                                                                                                              |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `package.json`           | [包清单](/engine/6000.0/manual/packages-list/cus-pkg-development/upm-manifest-pkg.md)，定义包依赖关系和其他元数据。此文件Name必须小写。                                                                                       |
| `README.md`              | 开发者包文档。此文档通常旨在帮助想要更包ON包的主枝推送新建Change的开发者。                                                                                                                                                           |
| `CHANGELOG.md`           | 按相反时间Order描述包更改。最好使用标准 Format，例如[保持变更日志](http://keepachangelog.com/en/1.0.0/)。                                                                                                                      |
| `LICENSE.md`             | 包含[包许可证文本](/engine/6000.0/manual/packages-list/cus-pkg-development/cus-legal.md)。通常，包管理器从选定的 [SPDX 列表网站](https://spdx.org/licenses/)复制文本。                                                           |
| `Third Party Notices.md` | 包含满足[法律要求](/engine/6000.0/manual/packages-list/cus-pkg-development/cus-legal.md)所需的信息。                                                                                                              |
| `Editor/`                | Editor 平台指定的 Assets Folder。与 Assets 下的 Editor 文件夹不同，这只是一种约定，不会影响资源导入管道。请参阅 [Assembly Definition 和包](/engine/6000.0/manual/packages-list/cus-pkg-development/cus-asmdef.md)以正确配置此文件夹中 Editor 指定的程序集。 |
| `Runtime/`               | 运行时平台指定的 Assets Folder。这只是一种约定，不会影响资源导入管道。请参阅 [Assembly Definition 和包](/engine/6000.0/manual/packages-list/cus-pkg-development/cus-asmdef.md)以正确配置此文件夹中的运行时程序集。                                     |
| `Tests/`                 | 用于存储包中[包含的测试](/engine/6000.0/manual/packages-list/cus-pkg-development/cus-tests.md)的 Folder。                                                                                                        |
| `Tests/Editor/`          | Editor 平台指定的的测试文件Folder。请参阅 [Assembly Definition 和包](/engine/6000.0/manual/packages-list/cus-pkg-development/cus-asmdef.md)以正确配置此文件夹中 Editor 指定的测试程序集。                                              |
| `Tests/Runtime/`         | 运行时平台指定的测试。请参阅 [Assembly Definition 和包](/engine/6000.0/manual/packages-list/cus-pkg-development/cus-asmdef.md)以正确配置此文件夹中的运行时测试程序集。                                                                  |
| `Samples~/`              | Folder，用于存储包中[包含的样本](/engine/6000.0/manual/packages-list/cus-pkg-development/cus-samples.md)。                                                                                                       |
| `Documentation~`         | Folder，用于存储包中[包含的文档](/engine/6000.0/manual/packages-list/cus-pkg-development/cus-document.md)。                                                                                                      |

Unity 会忽略以 `~` 角色结尾的任何 Folder Name 的内容，并且不会使用 `.meta` 文件来轨道这些内容。但是，您需要包含 `Editor`、`Runtime` 和 `Tests` 文件夹及其内容的`.meta`文件才能正常工作。有关 ON `.meta` 文件以及 Unity 如何使用这些文件进行跟踪的更多信息，请参阅[资源工作流程](/engine/6000.0/manual/assets-and-media/asset-workflow.md)。
