Unity中[SerializeField]和[HideInInspector]的使用

最新推荐文章于 2025-04-04 16:53:53 发布
最新推荐文章于 2025-04-04 16:53:53 发布
阅读量3.4k 收藏 36
点赞数 9
分类专栏： Unity Unity技巧 文章标签： unity 游戏开发
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/woodengm/article/details/117663291
版权

本文分享Unity中[SerializeField]和[HideInInspector]的使用

今天给大家分享几个特性的使用.

在Unity的开发中, 我们经常会使用到序列化技术. 那么什么是序列化呢?

序列化(Serialize)

序列化最质朴的解释就是我们按照一定的规则将数据组织和存储或者传输, 然后在某些时候或者某些点按照相同的规则将其解析出来.

现在有很多的序列化手段, 如常见的Xml, Json, Protobuf等, 相信很多同学都接触过.

这些手段或者说规则, 各有各的优势, 比如有的占用空间小, 便于网络传输, 有的格式清晰, 便于理解等等.

在C#中, 我们甚至可以将一个类对象给序列化, 然后进行持久化(也就是存储起来), 最后使用的时候反序列化出原来的对象.

大家知道, Unity中的Prefab是一种资源(Asset), 在内部其实也是使用序列化进行数据组织和存储.

将来有机会可以给大家再详细分享下Prefab的序列化结构, 这不是今天的重点.

Mono脚本组件的序列化

Unity会在内部对所有Mono脚本的组件进行序列化, 并在重启时动序列化数据中重新反序列化出组件.

默认情况下, 组件的公共字段(public field)会出现在Editor的Inspector面板中, 我们在面板上对字段的修改会被序列化存储起来, 避免在重载时丢失.

但是其它字段(非public, 静态等)或者属性(attribute)不会出现在Inspector面板, 也不会被序列化.

Unity提供了[SerializeField]特性对非静态的非公有字段进行序列化的手段, 只要在这一类字段上使用这个特性, 那么这个字段就会出现在Inspector面板并被序列化, 但依然是非公有的. 并且Unity会对出现的Inspector面板上的字段做一些名称适配, 比如去掉"m_", “_”, 小写变大写, 数字加空格等等.

如下所示:

public string name1;

[SerializeField]
protected string m_name2;

[SerializeField]
private string _name3;

[HideInInspector]
[NonSerialized]
public string name4;

// 相当于[HideInInspector]和[NonSerialized]一起使用
public string name { set; get; }

序列化字段显示到Inspector面板

当然, 其它的一些值, 比如静态字段, 属性等依然是不能进行序列化的.

Unity也提供了对公共字段的隐藏和非序列化特性[HideInInspector]和[NonSerialized].

但是大部分情况下我们可以用属性来代替这两个功能对字段进行限制.

最后在给大家总结下:

  • 默认情况下, 公有的字段是可以显示在面板上并且被序列化的.
  • 非静态非公有的字段, 可以使用[SerializeField]特性在保持访问权限的情况下进行面板显示和序列化.
  • 静态的字段, 静态和非静态的属性, 是不能被面板显示和序列化的, 即使使用[SerializeField]特性.
  • 可以使用[HideInInspector]和[NonSerialized]特性对公有的字段进行面板显示和序列化控制.

好了, 今天的分享就到这里, 希望对大家有所帮助.

Unity中的序列化和反序列化
L的博客
08-31 7423
序列化是指把对象转换为字节序列的过程，而反序列化是指把字节序列恢复为对象的过程。序列化最主要的用途就是传递对象和保存对象在Unity中保存和加载、prefab、scene、Inspector窗口、实例化预制体等都使用了序列化与反序列化。...
unity中的SerializeField(序列化)
cathy_2017的博客
03-27 2534
[Serializable]将类的实例持久化保存，可以保存在本地，也可以保存在别处。 unity中的SerializeField(序列化) Unity会自动为Public变量序列化(再次读取Unity时序列化的变量是有值的，不需要再次去赋值，因为它已经被保存下来了。) 什么样的值可以显示在面板上？ 已经被序列化，但是没有用[HideInInspector]标记的值 如果a是公有的序列化变...
Unity之SerializeField（序列化字段）的一点理解 (2014-05-08 16:32:06)
shenshaonan的专栏
10-18 1708
最近在学习NGUI代码时遇到SerializeField，理解得不是很透彻，所以百度了一下，有以下收获，希望能对自己和他人有所帮助。（在这里由衷感谢那位大侠的分享）        首先，Unity会自动为Public变量做序列化，序列化的意思是说再次读取Unity时序列化的变量是有值的，不需要你再次去赋值，因为它已经被保存下来。        然后，什么样的值会被显示在面板上呢？答案是：已经被
Unity：序列化（SerializeField）
最新发布
2402_88047672的博客
04-04 1578
/ 玩家的血量// 玩家的名字这些字段默认是私有的（private），意思是其他代码不能直接访问它们。这种设计是为了保护数据安全。但在某些场景下，比如Unity游戏开发，你希望这些字段可以在Unity编辑器中调整，或者保存到场景文件中，这样游戏运行时就能加载这些值。问题来了：私有的字段默认是不会被Unity或C#的序列化系统看到的，因为它们是“隐藏”的。那么怎么办？这就是[SerializeField]出场的地方。
HideInInspector 与SerializeField
luyuncsd123的专栏
03-19 9102
[HideInInspector]表示将原本显示在面板上的序列化值隐藏起来。 [SerializeField]表示将原本不会被序列化的私有变量和保护变量可以序列化，这么他们在下次读取时，就是你上次赋值的值。 1如果a是公有的序列化变量。 1.1如果你想要在面板中看到a，那么用： public int a; 1.2如果你不想在面板中看到a，那么用: [HideInInspector] publ
Unity中HideInInspector和SerializeField
aikb6223的博客
11-03 255
http://blog.sina.com.cn/s/blog_697b1b8c0102uxvn.html Unity会自动为Public变量做序列化，序列化的意思是说再次读取Unity时序列化的变量是有值的，不需要你再次去赋值，因为它已经被保存下来。 什么样的值会被显示在面板上？已经被序列化，但是没有用HideInInspe...
Unity3D中[SerializeField]特性的使用
热门推荐
yangyongUestc的博客
05-09 9万+
在Unity3d中Unity3D 中提供了非常方便的功能可以帮助用户将 成员变量 在Inspector中显示，并且定义Serialize关系。 也就是说凡是显示在Inspector 中的属性都同时具有Serialize功能。 1. public 变量 在没有加入任何Attribute的前提下，public变量是默认被视为可以被Serialize的。所以public声明的变量在Insp
Unity中HideInInspector和SerializeField一起使用
东夜
07-26 1862
原文第一次回答发布在百度知道上，网上很多人转了我的文章却没标明出处，更可笑的标明自己是原创作者。这里是原问题。 http://zhidao.baidu.com/link?url=LcYoLnSlyO7c77eRZk6J--Muz0YVZ8lLr8P2C-h32n-UM01PbgNwtJJPtTycGfm-AfikTkw2WL8pXmHdZmry-ilgrvo7kGP6t0blY4CDG4y
【Unity学习笔记】总结：unity中的中括号：[SerializeField][HideInInspector]等等（更新中）
WoW的博客
07-14 2812
1.[HideInInspector] 让 public 变量在编辑器里不显示： public int a = 4; [HideInInspector] public int b = 4; 2.[SerializeField] 让 private 在编辑器里显示 private int c = 4; [SerializeField]
unity SerializeField和public
09-14
SerializeField和public都是用于在Unity中进行序列化的关键字。 public关键字用于声明一个公共变量，这意味着该变量可以在面板中被序列化并在游戏运行时被访问和修改。公共变量会自动被Unity序列化并在Inspector...
Unity3D中[SerializeField]和[Serializable ]特性的使用
02-07 1万+
（一）[SerializeField]的使用 凡是显示在Inspector 中的属性都同时具有Serialize功能。 在没有加入任何Attribute的前提下，public变量是默认被视为可以被Serialize的。所以public声明的变量在Inspector面板中是可见的。而Private变量在Inspector视图面板是不可见的。 什么样的值会被显示在面板上呢？答案是：已经被序列化，...
Unity [HideInInspector]和[SerializeField]
uukosama的博客
10-16 504
[HideInInspector]用于隐藏Inspector面板中的某个public参数。 [SerializeField]用于将某个private参数显示在Inspector面板中。
Unity中SerializeField的使用
Aaron9489的博客
11-24 1125
Unity3D中[SerializeField]的使用介绍
Unity - SerializeField
oncruise的博客
10-22 204
https://docs.unity3d.com/ScriptReference/SerializeField.html
Unity字段修饰符SerializeField、HideInInspector、Range()
如果可以一直带着少年时的酷
12-11 611
*尽可能用[SerializeField]+private的组合，而不是public！**安全性更高一些。：让public变量不在引擎里显示。
[serializefield]
04-03
<think>好的，我现在需要帮助用户解决关于Unity中SerializeField的使用方法和错误解决方案。首先，我需要回忆一下用户提供的引用内容，看看是否有相关的信息可以引用。用户提供的引用2提到了检查变量定义、命名空间、脚本挂载等问题，这可能与SerializeField的常见错误相关。引用3提到了材质和编辑器模式下的保存，可能对SerializeField在编辑器中的使用有帮助。 首先，我应该解释什么是SerializeField。它是Unity中的一个属性，用于将私有或受保护的变量显示在Inspector面板，方便调试和设置，同时保持封装性。需要强调它的基本用法，比如如何声明变量，以及使用时需要注意的地方，比如不支持属性。 接下来是常见错误部分。根据引用2的内容，用户可能遇到的错误包括变量未显示、未正确初始化、命名空间问题、脚本未挂载等。例如，变量未显示可能是因为没有使用SerializeField或者变量是公有的，而Unity默认会序列化公有变量。这里需要提醒用户检查访问修饰符。 然后，错误解决方案需要分步骤说明，比如检查变量定义、命名空间是否正确（特别是如果用户使用了自定义命名空间）、脚本是否正确挂载到游戏对象上，以及编译错误的影响。引用2中的解决方案1、2、3都可以应用到这里。比如，检查变量是否正确定义，是否有拼写错误，或者是否在正确的命名空间下。 另外，引用3提到在编辑器模式下运行可以保存修改，这可能与SerializeField在编辑器中的使用有关。比如，用户可能在运行时修改了SerializeField变量，但取消运行后这些修改不会被保存，这时候需要提醒用户在编辑器模式下进行修改。 还需要提到代码示例，展示正确的使用方式，比如将SerializeField应用于私有变量，并确保脚本挂载到游戏对象上。同时，引用2中的示例代码可能帮助用户理解如何检查脚本挂载，比如在Start方法中打印日志确认脚本是否正常运行。 最后，生成相关问题时要涵盖常见的使用场景、错误处理、与public变量的区别、运行时修改的注意事项，以及如何调试相关问题。这些问题应该覆盖用户可能遇到的其他疑问，并引导他们进一步学习。 需要确保整个回答结构清晰，步骤明确，并且引用相关的引用内容来支持解决方案，比如在检查变量定义时引用引用2中的步骤1，检查命名空间时引用步骤2，检查脚本挂载时引用步骤3的示例等。同时，保持语言简洁，用中文表达，避免技术术语过于复杂，让用户容易理解。</think>### SerializeField 使用方法与错误解决方案 #### 1. **SerializeField 基础用法** - **作用**: 将非公有变量（私有、受保护）序列化并显示在 Unity Inspector 面板中，便于调试和赋值，同时保持代码封装性。 - **语法示例**: ```csharp using UnityEngine; public class Example : MonoBehaviour { [SerializeField] private int _health; // 私有变量显示在 Inspector } ``` - **注意**: - 仅用于字段（Field），不适用于属性（Property）。 - 支持基本类型、Unity 对象（如 `GameObject`）、可序列化自定义类（需标记 `[System.Serializable]`）。 --- #### 2. **常见错误与解决方案** ##### **错误 1: 变量未显示在 Inspector** - **原因**: - 变量未标记 `[SerializeField]` 且为私有/受保护类型。 - 变量为公有类型但被 `[HideInInspector]` 标记。 - **解决**: - 添加 `[SerializeField]` 并确保变量非静态。 - 检查是否误用 `[HideInInspector]` [^2]。 ##### **错误 2: 字段显示为空白或未初始化** - **原因**: - 变量类型不可序列化（如抽象类、接口）。 - 自定义类未标记 `[System.Serializable]`。 - **解决**: ```csharp [System.Serializable] public class CustomData { /*...*/ } [SerializeField] private CustomData _data; // 需标记可序列化 ``` ##### **错误 3: 脚本挂载后字段值未保存** - **原因**: - 在 Play 模式下修改字段值，但未保存场景或预制体。 - **解决**: - 在 Unity 编辑器非运行模式下修改字段值，并保存场景（`Ctrl+S`）或应用预制体更改（`Apply`）[^3]。 --- #### 3. **进阶使用技巧** - **默认值设置**: ```csharp [SerializeField] private float _speed = 5.0f; // Inspector 中显示默认值 5 ``` - **多对象批量赋值**: - 选中多个对象后，通过 Inspector 统一修改 `[SerializeField]` 字段值。 --- #### 4. **代码示例与验证** ```csharp using UnityEngine; public class Player : MonoBehaviour { [SerializeField] private int _maxHealth = 100; // 显示在 Inspector void Start() { Debug.Log($"初始生命值: {_maxHealth}"); // 验证值是否正确加载 } } ``` - **验证步骤**: 1. 将脚本挂载到 GameObject。 2. 在 Inspector 中修改 `_maxHealth` 值。 3. 运行游戏，检查控制台输出是否符合预期。 --- §§ 相关问题 §§ 1. 如何通过代码动态修改 `[SerializeField]` 字段的值？ 2. `[SerializeField]` 与 `public` 变量在内存管理上有何区别？ 3. 如何解决嵌套自定义类未显示在 Inspector 的问题？ 4. 为什么修改 `[SerializeField]` 的数组长度会导致数据丢失？ 5. 如何通过单元测试验证 `[SerializeField]` 字段的赋值逻辑？
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

拂面清风三点水

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值