前言在 Unity Editor 开发中我们经常需要写自定义窗口EditorWindow来做工具面板。比如调试 Dify 接口时需要一个窗口同时显示几段 JSON发送的query、标准流程standardProcess、以及 Dify 返回的结果。每段文本都很长自然就想到用ScrollView包起来鼠标停在区域内滚轮滚动。看起来非常简单的需求实际做的时候却出现了问题把SelectableLabel放进父级ScrollView里滚轮没反应而换成TextArea或LabelField滚轮正常。为什么三个控件对滚轮有这样的表现要弄清楚这件事需要先理解 IMGUI 的整体机制和理解控件对鼠标滚轮事件的处理方式。本文结合一个真实项目中的 Dify 调试窗口对GUILayout、EditorGUILayout、三个文本控件进行说明、以及讨论ScrollView滚轮失效的可能原因。本文涉及 Unity 内部实现的部分如控件对ScrollWheel的处理逻辑是基于实测行为做的推断并非 Unity 公开源码的逐行引用。凡不确定的部分都会明确标注。一、GUILayout 与 EditorGUILayout 是什么关系1. 两者的定位GUILayout和EditorGUILayout都是 Unity Immediate Mode GUI即时模式 GUI简称 IMGUI提供的绘制 API。它们的核心思想是每一帧重新绘制整个界面。GUILayout通用 IMGUI 绘制 API运行时Runtime游戏内和编辑器都能用。提供最基础的按钮、文本、滑动条、滚动视图等。EditorGUILayout编辑器专用只能在 Editor 程序集里用且主要作用于 Editor 窗口。它在GUILayout之上扩展了一批编辑器特有的控件比如PropertyField、ObjectField、TagField、HelpBox、InspectorTitlebar等。简单说EditorGUILayout是GUILayout的编辑器增强版。2. 为什么会有两套因为运行时 UI 不应该依赖编辑器类型UnityEditor命名空间在打包后不存在所以运行时只能用GUILayout。而编辑器工具为了方便可以用更高级的EditorGUILayout。两者共享同一套布局引擎和事件系统。GUILayout.BeginHorizontal/GUILayout.EndHorizontal和EditorGUILayout.BeginHorizontal/EditorGUILayout.EndHorizontal在底层是同一套 Group 机制可以混用但建议同一个代码块里保持一致避免混乱。3. 共同的布局机制自动布局栈IMGUI 的布局是栈式的。每调用一次Begin...就把一个新的布局组压栈End...弹出。控件绘制时会被自动归入当前栈顶的组里。GUILayout.BeginHorizontal();// 进入横向组GUILayout.Button(A);GUILayout.BeginVertical();// 进入纵向组栈顶GUILayout.Button(B);GUILayout.Button(C);GUILayout.EndVertical();// 弹出纵向组GUILayout.EndHorizontal();// 弹出横向组Begin和End必须严格配对少一个End会导致整帧布局错乱甚至报错。这是 IMGUI 最容易出错的地方之一。二、IMGUI 的事件模型绘制与事件是同一件事这是理解滚轮失效可能原因的前提也是 IMGUI 和 Retained Mode UI如 uGUI、UI Toolkit最大的区别。1. 每帧 OnGUI 会被调用多次OnGUI在一帧内会被 Unity 调用多次每次对应一个不同的EventLayout事件先跑一遍只为了计算布局尺寸不真正绘制。Repaint事件真正把界面画到屏幕上。鼠标/键盘事件MouseDown、MouseUp、MouseDrag、MouseMove、ScrollWheel、KeyDown、KeyUp等。每次OnGUI进来Event.current就是当前要处理的事件。所有控件GUILayout.Button、EditorGUILayout.LabelField等本质上都是一个函数它拿到当前事件决定要不要处理它。2. 事件被用掉就没了Use() 与 EventType.UsedIMGUI 事件系统里有一个关键概念一个事件在一帧里只能被消费一次。控件通过调用Event.current.Use()来声明这个事件我处理了。一旦Use()被调用Event.current.type就会从原来的类型比如ScrollWheel变成EventType.Used。后续所有控件看到EventType.Used时通常会直接跳过不做任何处理。这就是整个滚轮问题的核心滚轮事件最终被谁Use()掉决定了 ScrollView 能不能滚动。关于Use()的语义是 Unity 公开 API 行为Event.Use有公开文档这一点是确定的。下面具体哪个控件在哪一步调用了 Use属于推断。三、ScrollView 的滚动逻辑在哪里执行这是容易被误解的一点但很关键。EditorGUILayout.BeginScrollView和EndScrollView是一对。滚动条的绘制在BeginScrollView里但真正的是否滚动、滚动多少的判断和位移通常发生在EndScrollView阶段EndScrollView负责收尾并应用滚动偏移。为什么这个顺序重要因为在BeginScrollView和EndScrollView之间写的所有控件都会先于EndScrollView的滚动逻辑执行。也就是说scrollPosEditorGUILayout.BeginScrollView(scrollPos);// —— 这里面的控件先于下面的滚动判断执行 ——EditorGUILayout.SelectableLabel(longText);// 先执行EditorGUILayout.EndScrollView();// 滚动判断后执行如果中间的SelectableLabel已经把ScrollWheel事件Use()掉了那么当执行到EndScrollView时Event.current.type已经变成了UsedScrollView 的滚动逻辑看到Used就跳过 →不滚动。这一段滚动判断在 EndScrollView是基于 IMGUI 布局-事件分离模型和实测行为的推断。Unity 的 ScrollView 内部 C 源码并未完整公开无法 100% 逐行确认但从行为上完全自洽。四、三个文本控件LabelField / TextArea / SelectableLabel1. LabelFieldLabelField是最纯粹的显示文本控件。它只负责把文字画出来不接收任何鼠标/键盘输入事件。鼠标点它、滚轮滚它事件原样穿过交给后面的控件。常用形式// 普通标签EditorGUILayout.LabelField(标题);// 自动换行风格按宽度折行适合长文本EditorGUILayout.LabelField(longText,EditorStyles.wordWrappedLabel);// 带自定义样式颜色、字号、对齐等EditorGUILayout.LabelField(红色,newGUIStyle(GUI.skin.label){normal{textColorColor.red}});常用参数text要显示的字符串。第二个参数常传一个GUIStyle控制字体、颜色、换行、对齐。EditorStyles.wordWrappedLabel是常用的自动换行只读文本样式。GUILayout布局参数GUILayout.Width、GUILayout.Height、GUILayout.ExpandWidth等控制占用尺寸。特点绝对只读、不碰事件、不能选中复制。最常用但功能最少。2. TextAreaTextArea是一个可编辑的多行文本框。它内部维护一个TextEditor文本编辑器状态支持输入、删除、光标移动、选中文本、复制粘贴。常用形式// 可编辑文本区stringsEditorGUILayout.TextArea(text);// 只读展示风格用 wordWrappedLabel 样式看起来像标签但仍可选中复制EditorGUILayout.TextArea(text,EditorStyles.wordWrappedLabel,GUILayout.ExpandHeight(true));常用参数text当前文本。GUILayout.MinHeight/GUILayout.Height/GUILayout.ExpandHeight控制高度。ExpandHeight(true)让它尽量撑满父容器剩余空间。第二个参数可传GUIStyle控制外观。关键行为实测TextArea不会主动消费鼠标滚轮事件即使它获得了键盘焦点滚轮事件仍然原样传给父级 ScrollView父级正常滚动。这一点和很多人直觉相反——直觉会觉得聚焦的输入框会吞滚轮实际不会。3. SelectableLabelSelectableLabel的设计目的是可选可复制、但不能编辑的只读文本。它内部同样用TextEditor但处于一种特殊的只读可选模式。常用形式// 默认自动换行、可选中复制EditorGUILayout.SelectableLabel(longText);// 固定高度EditorGUILayout.SelectableLabel(longText,GUILayout.MinHeight(120));关键行为实测这是本文的核心结论把SelectableLabel放进父级 ScrollView滚轮完全失效。无论有没有焦点都不行。为什么合理推断是SelectableLabel为了支持鼠标拖选文本“选区在滚动时保持可视”选区超出可视区自动定位这些能力它内部的文本处理逻辑无条件消费了鼠标所在区域的ScrollWheel事件一进入控件就Use()掉。这样EndScrollView看到的已经是Used滚动逻辑被跳过。这个无条件 Use ScrollWheel的判断属于基于行为的推断不是从 Unity 源码确认的。我没有读 Unity 内部 C 的条件。但实测结果非常稳定只要内层是 SelectableLabel父级 ScrollView 就滚不动一换成 TextArea/LabelField立刻能滚。从事件只能被 Use 一次的公开机制反推最合理的解释就是 SelectableLabel 把事件吞了。五、为什么 SelectableLabel 失败、TextArea 和 LabelField 成功把前面几点合起来结论很清晰控件是否主动消费 ScrollWheel配父级 ScrollView能否选中复制是否可编辑LabelField否完全不碰事件成功不能否TextArea否聚焦与否都不吞成功能是SelectableLabel是推断为无条件吞失败能否核心链条ScrollWheel事件一帧只能被消费一次。ScrollView 的滚动应用发生在EndScrollView排在内部控件之后。SelectableLabel先把ScrollWheelUse 掉 →EndScrollView看到Used→ 不滚动。TextArea、LabelField不碰ScrollWheel→ 事件传到EndScrollView→ 正常滚动。正确选型在一个长文本放进固定高度区域、需要区域内滚轮的场景下要绝对只读用LabelFieldwordWrappedLabel样式最干净但没法复制。要能复制、又要滚轮可用用TextAreawordWrappedLabel样式推荐。它继承了 TextArea 的事件特性不抢滚轮又靠样式看起来像只读标签还保留了选中复制能力。唯一理论缺陷是用户可能误删显示内容对 Editor 测试工具来说可接受。别用SelectableLabel在放进父级 ScrollView的场景下它是无法实现滚动的功能。实测可用写法本项目最终采用GUILayout.Label(Query发送给 Dify 的提问数据,EditorStyles.boldLabel);EditorGUILayout.BeginVertical(HelpBox);_queryScrollEditorGUILayout.BeginScrollView(_queryScroll,GUILayout.MinHeight(120));// 用 wordWrappedLabel 让它显示成长文本ExpandHeight 撑满高度EditorGUILayout.TextArea(record.query,EditorStyles.wordWrappedLabel,GUILayout.ExpandHeight(true));EditorGUILayout.EndScrollView();EditorGUILayout.EndVertical();GUILayout.Space(5);六、常用 EditorWindow 绘制函数速查下面列出写 Editor 窗口最常用的函数给出用途、常用参数和效果。1. 布局控制// 横向组内部控件水平排列GUILayout.BeginHorizontal();GUILayout.EndHorizontal();// 纵向组内部控件垂直排列GUILayout.BeginVertical();GUILayout.EndVertical();// 区块样式传入 GUIStyle如 box、HelpBoxGUILayout.BeginVertical(box);GUILayout.EndVertical();布局组必须严格配对。2. 间距与弹性GUILayout.Space(10);// 固定像素间距GUILayout.FlexibleSpace();// 弹性空白撑满剩余空间常用于两端对齐3. 文本显示EditorGUILayout.LabelField(text);// 只读标签EditorGUILayout.LabelField(text,EditorStyles.wordWrappedLabel);// 自动换行只读EditorGUILayout.TextArea(text);// 可编辑多行EditorGUILayout.SelectableLabel(text);// 只读可选注意滚轮是否存在问题GUILayout.Label(text,EditorStyles.boldLabel);// 加粗标题4. 按钮if(GUILayout.Button(点击)){}// 普通按钮if(GUILayout.Button(点击,GUILayout.Height(30))){}// 固定高度if(GUILayout.Button(刷新,EditorStyles.toolbarButton)){}// 工具栏风格按钮GUILayout.Button在被点击的当帧返回true否则false。5. 滚动视图// 固定高度的滚动区域scrollPosEditorGUILayout.BeginScrollView(scrollPos,GUILayout.Height(150));// 内部控件EditorGUILayout.EndScrollView();常用参数第一参数Vector2 scrollPosition当前滚动位置用成员变量保存。GUILayout.Height/MinHeight控制视图高度超出部分靠滚动条。注意Begin/End配对。6. 输入控件stringsEditorGUILayout.TextField(名字,value);// 单行文本intnEditorGUILayout.IntField(数量,value);// 整数floatfEditorGUILayout.FloatField(速度,value);// 浮点boolbEditorGUILayout.Toggle(开关,value);// 勾选框intiEditorGUILayout.Popup(选项,index,options);// 下拉选择Vector3vEditorGUILayout.Vector3Field(位置,value);// 三维向量ColorcEditorGUILayout.ColorField(颜色,value);// 颜色这些都返回用户输入后的新值用返回值回写即可。7. 编辑器特有控件// 引用一个对象拖拽赋值ObjectobjEditorGUILayout.ObjectField(资源,value,typeof(GameObject),true);// 自动绘制一个序列化属性最常用在 InspectorEditorGUILayout.PropertyField(serializedProperty);// 带图标的提示框EditorGUILayout.HelpBox(这是一段提示,MessageType.Info);// Info / Warning / ErrorObjectField第四个参数allowSceneObjects表示是否允许拖入场景对象。8. 尺寸控制GUILayoutOptions这些可以附加到几乎任何绘制函数末尾GUILayout.Width(200)// 固定宽度GUILayout.Height(30)// 固定高度GUILayout.MinWidth(100)// 最小宽度GUILayout.MaxWidth(300)// 最大宽度GUILayout.MinHeight(120)// 最小高度GUILayout.ExpandWidth(true)// 是否横向撑满GUILayout.ExpandHeight(true)// 是否纵向撑满例GUILayout.Button(OK, GUILayout.Width(80), GUILayout.Height(30))。9. 窗口与重绘Repaint();// 手动触发窗口重绘异步操作完成后更新 UI 常用异步任务如网络请求完成后OnGUI不会自动重绘需要主动调用Repaint()刷新显示。七、结语这个滚轮问题看似很小但它正好暴露了 IMGUI 最容易被忽视的一点在即时模式里绘制和事件处理是同一件事控件之间通过Use()隐式协作。谁先把事件消费掉谁就决定了后面的行为。记住几个要点GUILayout是通用 IMGUIEditorGUILayout是编辑器增强版共享同一套布局和事件机制。一个事件一帧只能被Use()一次。ScrollView 的滚动应用排在内部控件之后所以内部控件一旦吞掉滚轮ScrollView 就无法使用滚轮。SelectableLabel会吞滚轮基于行为推断TextArea和LabelField不吞。长文本 父级 ScrollView 滚轮可用 可复制这个组合最优解是TextArea wordWrappedLabel。写 Editor 工具时理解了这套事件流再遇到滚轮不滚问题就能从事件被谁消费的角度去定位尝试解决问题。参考资料Unity Scripting API —EditorGUILayout官方文档编辑器绘制 API 总览https://docs.unity3d.com/ScriptReference/EditorGUILayout.htmlUnity Scripting API —GUILayout官方文档通用 IMGUI APIhttps://docs.unity3d.com/ScriptReference/GUILayout.htmlUnity Scripting API —GUI官方文档底层 GUI 类https://docs.unity3d.com/ScriptReference/GUI.htmlUnity Scripting API —EditorGUI官方文档非自动布局的编辑器绘制https://docs.unity3d.com/ScriptReference/EditorGUI.htmlUnity Scripting API —Event官方文档事件类型与Use()语义https://docs.unity3d.com/ScriptReference/Event.htmlUnity Scripting API —EventType官方文档包含ScrollWheel/Used等事件类型https://docs.unity3d.com/ScriptReference/EventType.htmlUnity Manual — “Editor Windows”官方手册自定义窗口基础https://docs.unity3d.com/Manual/editor-EditorWindows.html说明以上 Unity 官方文档确认了 IMGUI 的基本 API 行为GUILayout/EditorGUILayout的用法、Event.Use的语义、EventType的取值。但本文关于SelectableLabel内部为何吞掉 ScrollWheel的解释TextEditor无条件Use滚轮是基于反复实测的行为反推Unity 并未公开这部分内部 C 源码属于推断而非确认。如果未来 Unity 版本调整了SelectableLabel的事件处理逻辑本文的结论可能需要重新验证。