---
title: Unity Properties 简介
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/object-oriented-development/properties/intro
latest_url: https://docs.unity.com/zh-cn/engine/7000.0/manual/scripting/object-oriented-development/properties/intro.md
generated_at: 2026-11-16T11:39:45.728Z
locale: zh-cn
---

# Unity Properties 简介

> 了解 Unity Properties API 的基础知识和用法。

Unity Properties System允许您在运行时时探索和修改 C# 类型的Properties。它使用访问者样式 API，以可预测、可控的方式遍历Object图的 Properties。

您可以使用 Unity Properties 对 C# 类型进行通用读取或写入，只需进行最少的指定类型处理。这允许您使用自定义、用户定义的 C# 类型，例如验证它们，或在不同表示形式之间进行转换。

Unity Properties 可以避免或最大限度减少[反射](https://learn.microsoft.com/en-us/dotnet/fundamentals/reflection/reflection)，因为反射相对较慢，会分配内存（会增加垃圾回收器开销），并且 Support 有限，尤其是在需要使用 [IL2CPP](/engine/6000.0/manual/scripting/compilation-and-code-reload/script-compilation/backends/il2cpp.md) 进行提前 (AOT) 编译的 ON 平台上。

Unity Properties 可用于以下常见情况：

* 数据验证和处理：

  * 遍历Object图以验证范围、 null、引用或强制执行约束。
  * Properties性计算差异、哈希或Change检测。

* 复制、克隆和修补：
  * 通过访问和复制指定的 Properties 来深度复制容器或 Apply 补丁。

* 创作到运行时数据转化：
  * 例如，通过属性历将 ScriptableObject 配置数据转换为运行时时structs）。

## 基本Features##fundamental-features

Unity Properties 框架具有以下基本Features，可使用于通用手柄 C# 类型数据：

* [属性包](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-bags.md)：[`IPropertyBag<T>`](/engine/6000.0/script-reference/unity/properties/ipropertybag1.md)描述了类型 `T` 的字段和 Properties。Unity 会生属性，以便System可以枚举您类型的Properties。
* [访客](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors.md)：您可以使用 [`Visit<TContainer, TValue>`](/engine/6000.0/script-reference/unity/properties/ipropertyvisitor/visit.md) 之类的回调实现访问者。该框架遍历容器的Properties并根据属性调用逻辑。
* 适配器：用于自定义访问或转换指定类型的方式的钩子（例如，对`Vector3`、枚举、Collections的特殊处理）。
* [属性路径和遍历](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-paths.md)：支持通过具有受控 Depth 和选项的路径嵌套容器、数组、字典和寻址值。

有关使用这些功能的更多 Detailed 示例，请参阅[使用`PropertyVisitor`创建属性访问者](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors-property-visitor.md)和[使用低关卡 API 创建属性访问者](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors-low-level-api.md)。

## 其他资源##additional-resources

* [属性包](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-bags.md)
* [属性访问者](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors.md)
* [属性路径](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-paths.md)
* [使用 `PropertyVisitor` 创建属性访问者](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors-property-visitor.md)
* [使用低关卡 API 创建属性访问者](/engine/6000.0/manual/scripting/object-oriented-development/properties/property-visitors-low-level-api.md)
