Unity添加注释，在Inspector面板显示提示

最新推荐文章于 2025-10-25 14:02:59 发布

原创最新推荐文章于 2025-10-25 14:02:59 发布 · 1.7k 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#unity #游戏引擎

unity 专栏收录该内容

28 篇文章

订阅专栏

本文探讨了如何在Unity3D中使用注释工具增强代码可读性，同时介绍了高级开发技巧。重点讲解了Header和Tooltip的区别，并提供了实际代码示例。适合游戏开发者提升代码质量。

[Tooltip("显示注释")]//鼠标移到变量上后可以看到汉字

[Header("显示注释")]//直接在面板上显示汉字
public class Test : MonoBehaviour
{
[Header("显示注释")]
public string Header;
}

public class Test : MonoBehaviour
{
[Tooltip("显示注释")]
public string Tooltip;
}

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

unity_http

关注关注

1
点赞
踩
4

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

专栏目录

解决Unity编辑器Inspector视图中文注释乱码

ellis1970的博客

12-02

762

介绍解决Unity编辑器Inspector视图中文注释乱码的步骤

在unity脚本中控制Inspector面板的参数

weixin_44302602的博客

06-18

6799

在编写脚本的过程中我们会遇到一些小问题比如一个的变量为了在其他脚本中可以调用我们需要写成public类型的这样的话在Inspector面板中会出现此变量这篇博客会给大家介绍一些方法去避免这些小问题 1.[Header(" ")] 这个的作用是给它下面的所有变量一个总标题 2.[Tooltip("")] 这个的作用是给下面的第一行（紧邻的语句）注释这个注释和双斜杠的注释不同这个注释的...

参与评论您还未登录，请先登录后发表或查看评论

unity自定义特性在inspector面板上显示或者隐藏字段

09-19

使用自定义特性在unity的inspector面板上显示或者隐藏字段

在unity层级窗口作注释或备注的小工具

最新发布

2301_77778262的博客

10-25

这个放在Editor目录下。这个挂载到需要注释的节点中。

Unity Inspector面板上显示中文

keren2的博客

03-22

6054

在Unity上显示中文，可以这样搞，直接上代码 /*-------------------------------------------------------------------- * Author Name: DXL * Creation Time: 2018.10.11 * File Describe: Inspector面板上高级显示，例如显示中文 * ---------...

Unity开发——编辑器面板与脚本里的变量方法等的注解显示

青岚岁叶的博客

03-24

1412

Unity开发——脚本与编辑器面板里注解技巧： 1、多脚本使用时可快捷查看变量/方法的注解：summary 2、面板上显示数据详情：Serializable 3、面板显示字段变量的注解：Header 4、面板上动态显示字段的注解：Tooltip

在属性上面添加这个注释在unity界面能看到注释内容

chh19941125的专栏

06-22

5424

[Tooltip("攻击力")]

Unity脚本中枚举类型在inspector面板中文显示

qq_42345116的博客

02-22

1310

效果：工具脚本：ChineseEnumTool.cs using System; using UnityEngine; #if UNITY_EDITOR using UnityEditor; using System.Reflection; using System.Text.RegularExpressions; #endif /// <summary> /// 设置枚举名称 /// </summary> #if UNITY_EDITOR [AttributeUsage(A

自定义UI界面inspector面板（Editor）以及自定义参数在inspector面板内显示效果（PropertyDrawer）

qq_42720695的博客

08-11

1531

若要修改参数在inspector面板显示，需要新建一个脚本继承PropertyDrawer，然后添加特性[CustomPropertyDrawer(typeof(参数类名))]，然后实现OnGUI()方法，示例如下。该脚本继承Editor，加上特性[CustomEditor(typeof(具体界面类))]，然后实现OnInspectorGUI()方法即可自定义inspector显示面板，效果图如下。平时我们在搭建一个界面后都会给这个界面添加一个界面脚本，一般情况下都是普通的MonoBehaviour的。..

Unity3D——自定义类的Inspector面板的修改

qq_40472852的博客

07-22

1191

自定义类的Inspector面板修改

Unity 脚本的变量在Inspector面板中如何添加注释

R873112的博客

08-10

1847

[Tooltip("Set thelevel for this gameobject.")] //注释 [Range(0,1)] //范围 public float level = 1.0f; //变量 [SerializeField] float m_JumpPower = 12f; // [HideI...

Unity 使用注解通用设置Inspector窗口的显示内容

qq_53759768的博客

06-25

747

与网上常见的需要针对每个类单独设置的情况不同，此版本更加通用，但对应更大的开销。

Unity Inspector面板显示提示

梦想是世界和平

05-19

803

[Tooltip("显示注释")]//鼠标移到变量上后可以看到汉字 [Header("显示注释")]//直接在面板上显示汉字

unity--属性面板标记[xxx]

学海无涯

07-10

2054

unity [xxx]属性面板标记

unity 自定义特性,在Inspector面板显示自定义提示信息

weixin_27941997的博客

08-29

1163

【代码】unity 自定义特性,在Inspector面板显示自定义提示信息。

【Unity技术专题】属性标签、Attribute

yhx956058885的博客

10-19

1703

举两个例子，在变量上使用[SerializeFiled]属性，可以强制让变量进行序列化，可以在Unity的Editor上进行赋值。在Class上使用[RequireComponent]属性，就会在Class的GameObject上自动追加所需的Component。以下是Unity官网文档中找到的所有Attribute，下面将按照顺序，逐个对这些Attribute进行说明和小的测试。部分例子使用了Unity官方的示例。 UnityEngine AddComponentMenu 可以在Unity

unity初级——Inspector检视器面板开发

qq_53663718的博客

05-28

3170

检视器面板开发

unity中特性的运用，常用属性注释

dayuchiyu的博客

11-08

3131

转载地址：http://www.cnblogs.com/nsky/p/5275106.html 1. AddComponentMenu 描述：这个属性可以在Component这个菜单栏下加自己定义的子菜单，这样可以快速添加常用的脚本。该属性要用在类上。 using UnityEngine; using System.Collections; [AddComponentM

unity如何在inspectr面板中显示中文注释

08-09

<think>我们被要求使用中文回答，并且根据提供的引用内容来回答用户的问题。用户问题：我想在Unity的Inspector面板中显示中文注释根据引用内容，我们可以得到以下信息：引用[3]提到：Unity Inspector中文显示乱码问题，并给出了通过EditorConfig插件处理的方法。引用[4]提到：使用注解通用设置Inspector窗口的显示内容，但注意部分功能只应用于Editor，且存在一个不重要的错误。然而，用户的问题是关于“显示中文注释”，这里的“注释”可能指的是在Inspector面板中显示中文字段名（即public变量的名称）或者对字段的中文说明。在Unity中，默认情况下，public变量在Inspector面板中显示的是变量名（英文），如果变量名是中文，那么就会显示中文。但是，有时会出现乱码问题。另外，我们也可以通过特性（Attribute）来为字段添加自定义的显示名称，例如使用[Header("中文")]、[Tooltip("中文")]等，或者通过重写Inspector来显示中文注释。但是，用户特别提到了“注释”，可能是指代码中的注释（如XML注释）显示在Inspector面板中。然而，Unity默认并不支持将代码注释显示在Inspector面板上。因此，我们需要考虑其他方法。根据引用[4]提到的“使用注解通用设置Inspector窗口的显示内容”，我们可以使用自定义特性来显示中文文本，但这并不是直接显示代码注释。因此，回答应该包括： 1. 直接使用中文变量名（但要注意乱码问题及其解决方法）。 2. 使用Unity自带的特性（如[Header]、[Tooltip]）来显示中文。 3. 如果希望显示更复杂的注释，可能需要自定义Inspector（通过Editor脚本），并在自定义的Inspector中绘制中文文本。同时，引用[3]提供了解决中文乱码的方法：使用EditorConfig插件（在Visual Studio中安装）。但是，请注意，乱码问题可能出现在代码编辑器和Unity Inspector面板中。这里我们主要关注Inspector面板。步骤： 1. 在Visual Studio中安装EditorConfig插件（扩展->管理扩展->搜索EditorConfig并安装，重启VS）。 2. 在项目根目录创建.editorconfig文件，并设置编码为UTF-8。另外，Unity Inspector面板显示中文乱码还可能是因为字体不支持中文。可以尝试以下方法： - 使用支持中文的字体（如微软雅黑）替换Unity默认字体（需要修改Unity编辑器设置，但通常不推荐，因为会影响所有项目）。 - 或者在自定义Inspector时指定字体。然而，对于字段名的显示，Unity使用的是它自己的UI系统，所以如果出现乱码，可能是由于脚本文件编码问题。因此，我们建议： - 确保脚本文件保存为UTF-8编码（无BOM）。 - 在Visual Studio中设置编码：文件->高级保存选项->选择Unicode(UTF-8无签名)。总结回答：在Unity的Inspector面板中显示中文注释，可以通过以下方法实现： 1. **直接使用中文变量名**：将public字段的名称改为中文，例如： ```csharp public int 速度; ``` 这样在Inspector面板中就会显示“速度”。但请注意，如果出现乱码，请检查脚本文件的编码（确保为UTF-8无BOM）。 2. **使用Unity特性**：使用`[Header("中文标题")]`添加标题，使用`[Tooltip("中文提示")]`添加鼠标悬停提示。例如： ```csharp [Header("玩家设置")] [Tooltip("这是玩家的移动速度")] public float speed; ``` 3. **自定义Inspector（高级）**：如果希望显示更详细的中文注释，可以编写自定义的Inspector编辑器脚本。例如： ```csharp using UnityEditor; using UnityEngine; [CustomEditor(typeof(YourComponent))] public class YourComponentEditor : Editor { public override void OnInspectorGUI() { // 显示默认属性 DrawDefaultInspector(); // 添加注释 GUIStyle style = new GUIStyle(); style.normal.textColor = Color.gray; style.wordWrap = true; // 自动换行 EditorGUILayout.LabelField("这里是中文注释：这是一个重要的组件，用于控制玩家移动。", style); } } ``` 将上述脚本放在Editor文件夹下。这样，在YourComponent组件的Inspector面板底部就会显示一段中文注释。 4. **解决乱码问题**：如果出现中文乱码，请确保： - 脚本文件保存为UTF-8编码（无BOM）。在Visual Studio中，可以通过“文件”->“高级保存选项”来设置。 - 在Visual Studio中安装EditorConfig插件，并在项目根目录创建.editorconfig文件，内容如下： ``` root = true [*.cs] charset = utf-8 ``` - 如果是在自定义Inspector中显示中文出现乱码，可能是因为GUI样式使用的字体不支持中文。可以尝试设置字体： ```csharp style.font = Font.CreateDynamicFontFromOSFont("Microsoft YaHei", 14); ``` 注意：使用中文变量名虽然可行，但通常不推荐，因为代码中最好使用英文命名变量。建议使用第2种或第3种方法。根据引用[4]的提示，自定义Inspector时要注意将脚本放在Editor文件夹下，并且可能会遇到一个不重要的错误（'Editor.DisplayAttributeHelper' is missing the class attribute 'ExtensionOfNativeClass'!），但可以忽略。希望这些方法能够帮助您。相关问题： 1. 如何在Unity中修改Inspector面板的默认字体？ 2. 如何为Unity Inspector面板添加更丰富的样式？ 3. Unity Inspector面板支持哪些中文字体？ 4. 如何批量修改脚本的编码为UTF-8？</think>在Unity Inspector面板中显示中文注释，可以通过以下几种方法实现： ### 方法1：直接使用中文变量名（推荐）在脚本中声明`public`变量时，**直接使用中文变量名**，Unity会自动在Inspector面板显示中文标签： ```csharp public int 玩家血量; // Inspector将显示"玩家血量" public float 移动速度; // Inspector将显示"移动速度" ``` ### 方法2：使用`[Header]`和`[Tooltip]`特性 ```csharp [Header("战斗设置")] [Tooltip("玩家初始生命值")] public int playerHealth = 100; [Header("移动控制")] [Tooltip("角色移动速度系数")] public float moveSpeed = 5.0f; ``` ### 方法3：自定义Inspector（高级）通过Editor脚本实现复杂中文注释： 1. 在项目中创建`Editor`文件夹 2. 创建自定义编辑器脚本： ```csharp using UnityEditor; using UnityEngine; [CustomEditor(typeof(PlayerController))] public class PlayerControllerEditor : Editor { public override void OnInspectorGUI() { // 中文标题 EditorGUILayout.LabelField("玩家控制设置", EditorStyles.boldLabel); // 带中文注释的属性 EditorGUILayout.HelpBox("角色移动速度，值越大移动越快", MessageType.Info); serializedObject.FindProperty("moveSpeed").floatValue = EditorGUILayout.FloatField("移动速度", serializedObject.FindProperty("moveSpeed").floatValue); // 保存修改 serializedObject.ApplyModifiedProperties(); } } ``` ### 解决中文乱码问题 1. **VS Code/Visual Studio设置**： - 安装EditorConfig插件（VS扩展中搜索安装）[^3] - 在项目根目录创建`.editorconfig`文件： ```ini [*.cs] charset = utf-8 ``` 2. **脚本编码设置**： - 用文本编辑器打开脚本 - 保存为UTF-8编码（无BOM格式） 3. **Unity编辑器设置**： - `Edit → Project Settings → Editor` - 将`Asset Serialization Mode`改为`Force Text` ### 注意事项 1. 非`public`变量默认不显示，需添加`[SerializeField]`特性 2. 使用`[TextArea]`特性支持多行中文输入： ```csharp [TextArea(3, 10)] public string 角色描述 = "中文描述内容"; ``` 3. 避免使用生僻字，部分字体可能显示异常 > 建议优先使用方法1+方法2的组合方案，无需编写额外编辑器代码即可实现中文显示[^1][^4]。 --- ### 相关问题 1. 如何在Unity Inspector中隐藏特定变量？ 2. 如何为Unity Inspector添加自定义颜色标记？ 3. Unity Inspector中如何实现折叠面板效果？ 4. 如何解决Unity脚本中文字符保存后乱码的问题？