2026/7/31 15:45:12
FEATURED · 精选文章 
1. 项目概述为什么Unity开发者必须掌握编辑器扩展如果你是一个Unity开发者每天花在编辑器里的时间可能比写代码的时间还多。重复地拖拽预制体、手动调整参数、在层级视图和检视面板之间来回切换——这些操作看似简单但累积起来就是巨大的时间消耗。你有没有想过能不能让编辑器“听你的话”把那些繁琐、重复的操作一键搞定这就是Unity编辑器扩展Editor Extensions存在的意义。它不是一个遥不可及的“高级”功能而是每个希望提升开发效率、打造专业工作流的开发者都应该掌握的实用技能。今天我们就从一个最直观、最常用的切入点开始Unity Editor工具栏。你可能已经注意到了Unity编辑器窗口顶部有一排工具栏上面有变换工具、播放按钮等。但你是否知道你可以把自己的按钮、菜单、甚至复杂的交互面板“钉”在这个黄金位置想象一下把团队内部常用的资源检查工具、一键打包脚本、或者场景快速设置功能做成一个按钮放在这里整个团队的开发体验和效率将得到质的飞跃。这不仅仅是“偷懒”更是工程化思维和工具化能力的体现。通过自定义工具栏你能将个人或团队的最佳实践固化下来形成可复用的生产力工具。2. 核心思路理解Unity编辑器扩展的架构与入口在动手改造工具栏之前我们需要先理解Unity编辑器扩展的基本工作原理。Unity编辑器本身就是一个用C#和IMGUIImmediate Mode GUI构建的应用程序。当我们编写编辑器脚本时本质上是在与这个应用程序的API进行交互告诉它“在这里画一个按钮”、“当点击时执行这段逻辑”。2.1 关键命名空间与基类所有编辑器扩展代码都需要放在一个名为Editor的文件夹下或在程序集中标记为EditorUnity在编译时会特殊处理这些脚本确保它们只在编辑模式下运行不会被打包到最终游戏中。核心的命名空间是UnityEditor。对于工具栏扩展我们主要关注两个核心机制InitializeOnLoadMethod属性这是一个方法特性Attribute标记了的方法会在Unity编辑器启动、或包含该脚本的编译单元被重新编译后自动调用。它是我们进行初始化比如向工具栏注册自定义元素的理想位置。EditorApplication类这个静态类提供了对编辑器生命周期和事件的访问。特别是它的update委托我们可以订阅它以在每一帧执行代码这对于需要持续更新状态的工具栏元素比如显示实时FPS、内存使用情况非常有用。2.2 工具栏的定位与渲染层级Unity的工具栏区域在UI层级中属于顶层。我们无法像在游戏视图中使用UGUI或UI Toolkit那样去“放置”一个GameObject。相反我们需要使用EditorGUI或Handles等API在特定的编辑器窗口通常是SceneView或全局的EditorWindow回调中进行绘制。更高级的做法是使用UnityEditor.OverlaysAPI2019.3后引入来创建可停靠的覆盖层但这属于更进阶的内容。本篇我们先聚焦于最经典、兼容性最好的方法在SceneView中添加自定义GUI。注意直接在全局空间绘制GUI元素可能会与其他编辑器扩展冲突或影响性能。最佳实践是将自定义UI绘制在特定的、合适的上下文中例如SceneView对于场景工具来说是合理的。3. 实战创建你的第一个自定义工具栏按钮理论说得再多不如动手一试。我们来创建一个最简单的功能在Scene视图的工具栏区域添加一个按钮点击后可以在场景原点创建一个立方体。3.1 项目结构与脚本创建首先在你的Unity项目Assets目录下创建一个名为Editor的文件夹。所有编辑器扩展脚本都必须放在这个文件夹或其子文件夹下Unity才会正确识别。在Editor文件夹内创建一个新的C#脚本命名为CustomSceneToolbar。3.2 编写核心代码打开CustomSceneToolbar.cs将默认代码替换为以下内容using UnityEditor; using UnityEngine; using System.Collections.Generic; // 我们不需要继承MonoBehaviour public static class CustomSceneToolbar { // 这是一个静态构造函数当类被首次访问时调用。 // 配合InitializeOnLoadMethod确保我们的注册逻辑在编辑器启动时执行。 [InitializeOnLoadMethod] private static void Initialize() { // 订阅Scene视图的GUI绘制委托 SceneView.duringSceneGui OnDuringSceneGui; Debug.Log(自定义场景工具栏已加载。); } // 这个方法将在每一帧Scene视图绘制时被调用 private static void OnDuringSceneGui(SceneView sceneView) { // 1. 开始一个横向布局区域模拟工具栏的样式。 // 我们将这个区域绘制在Scene视图的顶部。 Handles.BeginGUI(); // 切换到GUI绘制上下文 // 计算一个矩形区域位于Scene视图左上角宽度200高度30 Rect toolbarRect new Rect(10, 10, 200, 30); GUILayout.BeginArea(toolbarRect); { // 使用HorizontalLayout来水平排列按钮 GUILayout.BeginHorizontal(); { // 设置一个固定的按钮宽度看起来更整齐 GUILayoutOption buttonWidth GUILayout.Width(80); // 绘制“创建立方体”按钮 if (GUILayout.Button(创建立方体, buttonWidth)) { CreateCubeAtOrigin(); } // 可以继续添加更多按钮... if (GUILayout.Button(清空对象, buttonWidth)) { ClearAllCubes(); } } GUILayout.EndHorizontal(); } GUILayout.EndArea(); Handles.EndGUI(); // 结束GUI绘制 } private static void CreateCubeAtOrigin() { // 创建一个简单的立方体游戏对象 GameObject cube GameObject.CreatePrimitive(PrimitiveType.Cube); cube.name Editor_Created_Cube; cube.transform.position Vector3.zero; // 选中新创建的对象方便用户操作 Selection.activeGameObject cube; Debug.Log($已在原点创建立方体: {cube.name}); } private static void ClearAllCubes() { // 查找场景中所有由我们工具创建的立方体 GameObject[] allCubes GameObject.FindGameObjectsWithTag(EditorOnly); // 建议使用Tag这里仅为示例 // 更健壮的做法通过名称或自定义组件来查找 ListGameObject toDestroy new ListGameObject(); foreach (var obj in GameObject.FindObjectsOfTypeGameObject()) { if (obj.name.Contains(Editor_Created_Cube)) { toDestroy.Add(obj); } } foreach (var obj in toDestroy) { Object.DestroyImmediate(obj); } Debug.Log($已清理 {toDestroy.Count} 个立方体。); } }3.3 代码解析与关键点[InitializeOnLoadMethod]这是整个扩展的“发动机启动键”。它确保Initialize方法在编辑器启动或代码重编译后自动运行无需开发者手动调用。SceneView.duringSceneGui OnDuringSceneGui;这是核心的注册逻辑。我们将自定义的OnDuringSceneGui方法订阅到SceneView的绘制事件中。从此每当Scene视图刷新我们的方法就会被调用获得一次绘制UI的机会。Handles.BeginGUI()/Handles.EndGUI()这对调用至关重要。它们将当前的绘图上下文从3D手柄Handles绘制切换到2D GUIIMGUI绘制。所有GUILayout或GUI类的绘制代码都必须包裹在这对语句之间。GUILayout.BeginArea我们在Scene视图的“画布”上划定了一块矩形区域toolbarRect作为我们的自定义工具栏容器。坐标(10, 10)表示距离左上角10个像素。GUILayout.Button绘制一个按钮。当按钮被点击时if(GUILayout.Button(...))语句块内的代码例如CreateCubeAtOrigin()就会执行。保存脚本返回Unity编辑器。等待编译完成后打开或切换到一个Scene视图。你应该能在视图的左上角看到两个按钮“创建立方体”和“清空对象”。点击测试一下功能吧4. 进阶技巧打造更专业、更强大的工具栏基础的按钮已经实现了但它看起来还有点简陋功能也单一。下面我们来提升它的实用性、美观度和健壮性。4.1 添加图标与工具提示纯文字的按钮不够直观。Unity内置了丰富的编辑器图标我们可以直接使用。修改按钮绘制部分的代码// 使用EditorGUIUtility.IconContent加载内置图标 GUIContent cubeContent new GUIContent( Cube, EditorGUIUtility.IconContent(d_CubeMesh Icon).image); GUIContent clearContent new GUIContent( Clear, EditorGUIUtility.IconContent(d_TreeEditor.Trash).image); if (GUILayout.Button(cubeContent, buttonWidth)) { CreateCubeAtOrigin(); } if (GUILayout.Button(clearContent, buttonWidth)) { ClearAllCubes(); }“d_CubeMesh Icon”和“d_TreeEditor.Trash”是Unity内部图标的标识符。你可以在Unity官方文档中搜索“EditorGUIUtility.IconContent”找到图标列表或者通过一些社区工具来浏览所有可用图标。GUIContent构造函数中的第一个字符串参数如“ Cube”会作为工具提示Tooltip当鼠标悬停在按钮上时显示。4.2 实现可折叠/可拖拽的工具栏固定位置的工具栏可能会遮挡场景内容。我们可以实现一个可折叠的窗口。首先我们需要一个布尔变量来控制工具栏的显示状态并绘制一个更复杂的窗口。public static class CustomSceneToolbar { private static bool isToolbarVisible true; // 控制显示/隐藏 private static Rect toolbarWindowRect new Rect(10, 10, 220, 80); // 窗口初始位置和大小 [InitializeOnLoadMethod] private static void Initialize() { /* 订阅事件同上 */ } private static void OnDuringSceneGui(SceneView sceneView) { if (!isToolbarVisible) return; // 如果隐藏则不绘制 Handles.BeginGUI(); // 使用GUI.Window来创建一个可拖拽的窗口 toolbarWindowRect GUI.Window(0, toolbarWindowRect, DrawToolbarWindow, 快捷工具); Handles.EndGUI(); } private static void DrawToolbarWindow(int windowID) { // 绘制一个关闭按钮在窗口右上角 if (GUI.Button(new Rect(toolbarWindowRect.width - 20, 2, 18, 18), x)) { isToolbarVisible false; } GUILayout.BeginVertical(); if (GUILayout.Button(创建立方体)) { CreateCubeAtOrigin(); } if (GUILayout.Button(创建光源)) { GameObject light new GameObject(Directional Light); light.AddComponentLight().type LightType.Directional; light.transform.rotation Quaternion.Euler(50, -30, 0); Selection.activeGameObject light; } // 可以添加更多工具... GUILayout.EndVertical(); GUI.DragWindow(); // 允许拖拽窗口 } }现在你的工具栏变成了一个可以拖拽、有关闭按钮的小窗口专业感立刻提升了。4.3 使用ScriptableObject保存工具栏配置关闭编辑器后工具栏窗口的位置、显示状态等信息会丢失。为了持久化这些用户偏好我们可以使用ScriptableObject结合EditorPrefs。创建配置数据类在Editor文件夹内using UnityEngine; using System; [Serializable] public class ToolbarSettings : ScriptableObject { public bool isVisible true; public Rect windowRect new Rect(10, 10, 220, 80); // 可以保存其他设置如颜色、常用路径等 }在工具栏类中加载和保存配置private static ToolbarSettings settings; private static string settingsKey “CustomToolbar_Settings“; [InitializeOnLoadMethod] private static void Initialize() { LoadSettings(); SceneView.duringSceneGui OnDuringSceneGui; // 订阅编辑器退出事件保存设置 EditorApplication.quitting SaveSettings; } private static void LoadSettings() { string data EditorPrefs.GetString(settingsKey, ““); if (!string.IsNullOrEmpty(data)) { settings JsonUtility.FromJsonToolbarSettings(data); } if (settings null) { settings ScriptableObject.CreateInstanceToolbarSettings(); } isToolbarVisible settings.isVisible; toolbarWindowRect settings.windowRect; } private static void SaveSettings() { settings.isVisible isToolbarVisible; settings.windowRect toolbarWindowRect; string data JsonUtility.ToJson(settings); EditorPrefs.SetString(settingsKey, data); }这样用户的工具栏布局就能在编辑器会话之间保留了。5. 避坑指南与性能优化在实际开发中你会遇到各种问题。以下是我踩过坑后总结的经验5.1 常见问题排查问题现象可能原因解决方案脚本编译无误但工具栏不显示1. 脚本未放在Editor文件夹下。2.InitializeOnLoadMethod标记的方法不是static的。3. 未正确订阅事件如拼写错误。1. 检查脚本路径。2. 确保初始化方法是private static。3. 检查SceneView.duringSceneGui ...这行代码是否执行可在方法开头加Debug.Log。按钮点击无反应1. GUI绘制代码不在Handles.Begin/EndGUI之间。2. 按钮的点击事件判断逻辑写错如用了而不是但IMGUI中通常是if(GUI.Button(...))。3. 有异常被抛出但未显示。1. 确认Handles.BeginGUI()和Handles.EndGUI()成对出现且包裹了按钮代码。2. 检查if语句块。3. 在按钮回调方法内用try-catch包裹并打印日志。自定义UI与其他插件冲突或位置错乱1. 矩形区域Rect计算有误或使用了绝对坐标在不同分辨率下错位。2. 多个扩展同时向duringSceneGui注册绘制顺序不可控。1. 使用GUILayout相对布局或基于sceneView.position等动态计算坐标。2. 尽量缩小自定义UI的绘制区域避免全局覆盖。对于重要UI考虑使用EditorWindow或Overlay。编辑器运行变卡在duringSceneGui中执行了耗时操作如每帧查找大量游戏对象、进行复杂计算。duringSceneGui每帧调用必须保持轻量。将耗时操作移到按钮点击事件中或使用缓存机制如每N帧更新一次数据。5.2 性能优化要点精简OnDuringSceneGui逻辑这个回调每帧都可能执行多次每个Scene视图一次。确保其中的代码是轻量级的。避免在内部进行GameObject.Find、GetComponent等耗时查询。如果需要动态数据考虑在按钮点击时或使用EditorApplication.update以较低频率更新。条件性绘制如果工具栏内容复杂但并非总是需要显示可以使用条件判断来跳过大部分绘制逻辑。例如只有当一个特定类型的对象被选中时才绘制相关的工具按钮。重用GUIContent和GUIStyle避免在每帧的GUI调用中创建新的GUIContent或GUIStyle对象。在类级别声明并初始化它们然后重复使用。这能有效减少GC垃圾回收压力。考虑使用UI Toolkit实验性对于非常复杂的自定义编辑器界面传统的IMGUI即GUI/GUILayout在性能和布局灵活性上可能成为瓶颈。Unity正在推动UI Toolkit作为新一代编辑器UI解决方案。虽然为Scene视图嵌入UI Toolkit Overlay在2022年之前的版本中较为复杂但它是未来趋势对于大型工具值得研究。6. 从工具栏到完整编辑器工具链的思考自定义工具栏只是一个起点。它的真正威力在于作为你个性化工作流的中枢。你可以以此为发射台集成更多强大功能批量处理器一个按钮批量处理选中的所有模型导入设置、或所有预制体的碰撞体生成。场景快照与切换快速保存当前场景的摄像机位置、对象状态并能一键恢复。资源检查与报告扫描项目找出未使用的资产、材质球引用丢失的模型并生成报告。与外部工具联动通过按钮触发Python脚本进行数据处理或调用命令行工具进行版本管理。我个人的体会是开发编辑器工具最大的回报不是节省的那几分钟操作时间而是思维模式的转变。你开始从“手动操作者”变为“自动化流程的设计者”。你会自然而然地思考这个重复性任务能否抽象那个易出错的操作能否通过工具校验这种能力会让你在团队中变得不可替代也是迈向技术策划或TA技术美术方向的重要基石。最后分享一个小技巧多使用[MenuItem]特性来创建顶部菜单栏的快捷方式然后将其中最常用的功能“搬运”到你的自定义工具栏上。这样你就构建了一个符合自己操作习惯的“效率仪表盘”。工具是死的工作流是活的。不断打磨你的工具链让它真正为你服务这才是学习编辑器扩展的终极目的。
Unity编辑器扩展实战：自定义工具栏提升开发效率
1. 项目概述为什么Unity开发者必须掌握编辑器扩展如果你是一个Unity开发者每天花在编辑器里的时间可能比写代码的时间还多。重复地拖拽预制体、手动调整参数、在层级视图和检视面板之间来回切换——这些操作看似简单但累积起来就是巨大的时间消耗。你有没有想过能不能让编辑器“听你的话”把那些繁琐、重复的操作一键搞定这就是Unity编辑器扩展Editor Extensions存在的意义。它不是一个遥不可及的“高级”功能而是每个希望提升开发效率、打造专业工作流的开发者都应该掌握的实用技能。今天我们就从一个最直观、最常用的切入点开始Unity Editor工具栏。你可能已经注意到了Unity编辑器窗口顶部有一排工具栏上面有变换工具、播放按钮等。但你是否知道你可以把自己的按钮、菜单、甚至复杂的交互面板“钉”在这个黄金位置想象一下把团队内部常用的资源检查工具、一键打包脚本、或者场景快速设置功能做成一个按钮放在这里整个团队的开发体验和效率将得到质的飞跃。这不仅仅是“偷懒”更是工程化思维和工具化能力的体现。通过自定义工具栏你能将个人或团队的最佳实践固化下来形成可复用的生产力工具。2. 核心思路理解Unity编辑器扩展的架构与入口在动手改造工具栏之前我们需要先理解Unity编辑器扩展的基本工作原理。Unity编辑器本身就是一个用C#和IMGUIImmediate Mode GUI构建的应用程序。当我们编写编辑器脚本时本质上是在与这个应用程序的API进行交互告诉它“在这里画一个按钮”、“当点击时执行这段逻辑”。2.1 关键命名空间与基类所有编辑器扩展代码都需要放在一个名为Editor的文件夹下或在程序集中标记为EditorUnity在编译时会特殊处理这些脚本确保它们只在编辑模式下运行不会被打包到最终游戏中。核心的命名空间是UnityEditor。对于工具栏扩展我们主要关注两个核心机制InitializeOnLoadMethod属性这是一个方法特性Attribute标记了的方法会在Unity编辑器启动、或包含该脚本的编译单元被重新编译后自动调用。它是我们进行初始化比如向工具栏注册自定义元素的理想位置。EditorApplication类这个静态类提供了对编辑器生命周期和事件的访问。特别是它的update委托我们可以订阅它以在每一帧执行代码这对于需要持续更新状态的工具栏元素比如显示实时FPS、内存使用情况非常有用。2.2 工具栏的定位与渲染层级Unity的工具栏区域在UI层级中属于顶层。我们无法像在游戏视图中使用UGUI或UI Toolkit那样去“放置”一个GameObject。相反我们需要使用EditorGUI或Handles等API在特定的编辑器窗口通常是SceneView或全局的EditorWindow回调中进行绘制。更高级的做法是使用UnityEditor.OverlaysAPI2019.3后引入来创建可停靠的覆盖层但这属于更进阶的内容。本篇我们先聚焦于最经典、兼容性最好的方法在SceneView中添加自定义GUI。注意直接在全局空间绘制GUI元素可能会与其他编辑器扩展冲突或影响性能。最佳实践是将自定义UI绘制在特定的、合适的上下文中例如SceneView对于场景工具来说是合理的。3. 实战创建你的第一个自定义工具栏按钮理论说得再多不如动手一试。我们来创建一个最简单的功能在Scene视图的工具栏区域添加一个按钮点击后可以在场景原点创建一个立方体。3.1 项目结构与脚本创建首先在你的Unity项目Assets目录下创建一个名为Editor的文件夹。所有编辑器扩展脚本都必须放在这个文件夹或其子文件夹下Unity才会正确识别。在Editor文件夹内创建一个新的C#脚本命名为CustomSceneToolbar。3.2 编写核心代码打开CustomSceneToolbar.cs将默认代码替换为以下内容using UnityEditor; using UnityEngine; using System.Collections.Generic; // 我们不需要继承MonoBehaviour public static class CustomSceneToolbar { // 这是一个静态构造函数当类被首次访问时调用。 // 配合InitializeOnLoadMethod确保我们的注册逻辑在编辑器启动时执行。 [InitializeOnLoadMethod] private static void Initialize() { // 订阅Scene视图的GUI绘制委托 SceneView.duringSceneGui OnDuringSceneGui; Debug.Log(自定义场景工具栏已加载。); } // 这个方法将在每一帧Scene视图绘制时被调用 private static void OnDuringSceneGui(SceneView sceneView) { // 1. 开始一个横向布局区域模拟工具栏的样式。 // 我们将这个区域绘制在Scene视图的顶部。 Handles.BeginGUI(); // 切换到GUI绘制上下文 // 计算一个矩形区域位于Scene视图左上角宽度200高度30 Rect toolbarRect new Rect(10, 10, 200, 30); GUILayout.BeginArea(toolbarRect); { // 使用HorizontalLayout来水平排列按钮 GUILayout.BeginHorizontal(); { // 设置一个固定的按钮宽度看起来更整齐 GUILayoutOption buttonWidth GUILayout.Width(80); // 绘制“创建立方体”按钮 if (GUILayout.Button(创建立方体, buttonWidth)) { CreateCubeAtOrigin(); } // 可以继续添加更多按钮... if (GUILayout.Button(清空对象, buttonWidth)) { ClearAllCubes(); } } GUILayout.EndHorizontal(); } GUILayout.EndArea(); Handles.EndGUI(); // 结束GUI绘制 } private static void CreateCubeAtOrigin() { // 创建一个简单的立方体游戏对象 GameObject cube GameObject.CreatePrimitive(PrimitiveType.Cube); cube.name Editor_Created_Cube; cube.transform.position Vector3.zero; // 选中新创建的对象方便用户操作 Selection.activeGameObject cube; Debug.Log($已在原点创建立方体: {cube.name}); } private static void ClearAllCubes() { // 查找场景中所有由我们工具创建的立方体 GameObject[] allCubes GameObject.FindGameObjectsWithTag(EditorOnly); // 建议使用Tag这里仅为示例 // 更健壮的做法通过名称或自定义组件来查找 ListGameObject toDestroy new ListGameObject(); foreach (var obj in GameObject.FindObjectsOfTypeGameObject()) { if (obj.name.Contains(Editor_Created_Cube)) { toDestroy.Add(obj); } } foreach (var obj in toDestroy) { Object.DestroyImmediate(obj); } Debug.Log($已清理 {toDestroy.Count} 个立方体。); } }3.3 代码解析与关键点[InitializeOnLoadMethod]这是整个扩展的“发动机启动键”。它确保Initialize方法在编辑器启动或代码重编译后自动运行无需开发者手动调用。SceneView.duringSceneGui OnDuringSceneGui;这是核心的注册逻辑。我们将自定义的OnDuringSceneGui方法订阅到SceneView的绘制事件中。从此每当Scene视图刷新我们的方法就会被调用获得一次绘制UI的机会。Handles.BeginGUI()/Handles.EndGUI()这对调用至关重要。它们将当前的绘图上下文从3D手柄Handles绘制切换到2D GUIIMGUI绘制。所有GUILayout或GUI类的绘制代码都必须包裹在这对语句之间。GUILayout.BeginArea我们在Scene视图的“画布”上划定了一块矩形区域toolbarRect作为我们的自定义工具栏容器。坐标(10, 10)表示距离左上角10个像素。GUILayout.Button绘制一个按钮。当按钮被点击时if(GUILayout.Button(...))语句块内的代码例如CreateCubeAtOrigin()就会执行。保存脚本返回Unity编辑器。等待编译完成后打开或切换到一个Scene视图。你应该能在视图的左上角看到两个按钮“创建立方体”和“清空对象”。点击测试一下功能吧4. 进阶技巧打造更专业、更强大的工具栏基础的按钮已经实现了但它看起来还有点简陋功能也单一。下面我们来提升它的实用性、美观度和健壮性。4.1 添加图标与工具提示纯文字的按钮不够直观。Unity内置了丰富的编辑器图标我们可以直接使用。修改按钮绘制部分的代码// 使用EditorGUIUtility.IconContent加载内置图标 GUIContent cubeContent new GUIContent( Cube, EditorGUIUtility.IconContent(d_CubeMesh Icon).image); GUIContent clearContent new GUIContent( Clear, EditorGUIUtility.IconContent(d_TreeEditor.Trash).image); if (GUILayout.Button(cubeContent, buttonWidth)) { CreateCubeAtOrigin(); } if (GUILayout.Button(clearContent, buttonWidth)) { ClearAllCubes(); }“d_CubeMesh Icon”和“d_TreeEditor.Trash”是Unity内部图标的标识符。你可以在Unity官方文档中搜索“EditorGUIUtility.IconContent”找到图标列表或者通过一些社区工具来浏览所有可用图标。GUIContent构造函数中的第一个字符串参数如“ Cube”会作为工具提示Tooltip当鼠标悬停在按钮上时显示。4.2 实现可折叠/可拖拽的工具栏固定位置的工具栏可能会遮挡场景内容。我们可以实现一个可折叠的窗口。首先我们需要一个布尔变量来控制工具栏的显示状态并绘制一个更复杂的窗口。public static class CustomSceneToolbar { private static bool isToolbarVisible true; // 控制显示/隐藏 private static Rect toolbarWindowRect new Rect(10, 10, 220, 80); // 窗口初始位置和大小 [InitializeOnLoadMethod] private static void Initialize() { /* 订阅事件同上 */ } private static void OnDuringSceneGui(SceneView sceneView) { if (!isToolbarVisible) return; // 如果隐藏则不绘制 Handles.BeginGUI(); // 使用GUI.Window来创建一个可拖拽的窗口 toolbarWindowRect GUI.Window(0, toolbarWindowRect, DrawToolbarWindow, 快捷工具); Handles.EndGUI(); } private static void DrawToolbarWindow(int windowID) { // 绘制一个关闭按钮在窗口右上角 if (GUI.Button(new Rect(toolbarWindowRect.width - 20, 2, 18, 18), x)) { isToolbarVisible false; } GUILayout.BeginVertical(); if (GUILayout.Button(创建立方体)) { CreateCubeAtOrigin(); } if (GUILayout.Button(创建光源)) { GameObject light new GameObject(Directional Light); light.AddComponentLight().type LightType.Directional; light.transform.rotation Quaternion.Euler(50, -30, 0); Selection.activeGameObject light; } // 可以添加更多工具... GUILayout.EndVertical(); GUI.DragWindow(); // 允许拖拽窗口 } }现在你的工具栏变成了一个可以拖拽、有关闭按钮的小窗口专业感立刻提升了。4.3 使用ScriptableObject保存工具栏配置关闭编辑器后工具栏窗口的位置、显示状态等信息会丢失。为了持久化这些用户偏好我们可以使用ScriptableObject结合EditorPrefs。创建配置数据类在Editor文件夹内using UnityEngine; using System; [Serializable] public class ToolbarSettings : ScriptableObject { public bool isVisible true; public Rect windowRect new Rect(10, 10, 220, 80); // 可以保存其他设置如颜色、常用路径等 }在工具栏类中加载和保存配置private static ToolbarSettings settings; private static string settingsKey “CustomToolbar_Settings“; [InitializeOnLoadMethod] private static void Initialize() { LoadSettings(); SceneView.duringSceneGui OnDuringSceneGui; // 订阅编辑器退出事件保存设置 EditorApplication.quitting SaveSettings; } private static void LoadSettings() { string data EditorPrefs.GetString(settingsKey, ““); if (!string.IsNullOrEmpty(data)) { settings JsonUtility.FromJsonToolbarSettings(data); } if (settings null) { settings ScriptableObject.CreateInstanceToolbarSettings(); } isToolbarVisible settings.isVisible; toolbarWindowRect settings.windowRect; } private static void SaveSettings() { settings.isVisible isToolbarVisible; settings.windowRect toolbarWindowRect; string data JsonUtility.ToJson(settings); EditorPrefs.SetString(settingsKey, data); }这样用户的工具栏布局就能在编辑器会话之间保留了。5. 避坑指南与性能优化在实际开发中你会遇到各种问题。以下是我踩过坑后总结的经验5.1 常见问题排查问题现象可能原因解决方案脚本编译无误但工具栏不显示1. 脚本未放在Editor文件夹下。2.InitializeOnLoadMethod标记的方法不是static的。3. 未正确订阅事件如拼写错误。1. 检查脚本路径。2. 确保初始化方法是private static。3. 检查SceneView.duringSceneGui ...这行代码是否执行可在方法开头加Debug.Log。按钮点击无反应1. GUI绘制代码不在Handles.Begin/EndGUI之间。2. 按钮的点击事件判断逻辑写错如用了而不是但IMGUI中通常是if(GUI.Button(...))。3. 有异常被抛出但未显示。1. 确认Handles.BeginGUI()和Handles.EndGUI()成对出现且包裹了按钮代码。2. 检查if语句块。3. 在按钮回调方法内用try-catch包裹并打印日志。自定义UI与其他插件冲突或位置错乱1. 矩形区域Rect计算有误或使用了绝对坐标在不同分辨率下错位。2. 多个扩展同时向duringSceneGui注册绘制顺序不可控。1. 使用GUILayout相对布局或基于sceneView.position等动态计算坐标。2. 尽量缩小自定义UI的绘制区域避免全局覆盖。对于重要UI考虑使用EditorWindow或Overlay。编辑器运行变卡在duringSceneGui中执行了耗时操作如每帧查找大量游戏对象、进行复杂计算。duringSceneGui每帧调用必须保持轻量。将耗时操作移到按钮点击事件中或使用缓存机制如每N帧更新一次数据。5.2 性能优化要点精简OnDuringSceneGui逻辑这个回调每帧都可能执行多次每个Scene视图一次。确保其中的代码是轻量级的。避免在内部进行GameObject.Find、GetComponent等耗时查询。如果需要动态数据考虑在按钮点击时或使用EditorApplication.update以较低频率更新。条件性绘制如果工具栏内容复杂但并非总是需要显示可以使用条件判断来跳过大部分绘制逻辑。例如只有当一个特定类型的对象被选中时才绘制相关的工具按钮。重用GUIContent和GUIStyle避免在每帧的GUI调用中创建新的GUIContent或GUIStyle对象。在类级别声明并初始化它们然后重复使用。这能有效减少GC垃圾回收压力。考虑使用UI Toolkit实验性对于非常复杂的自定义编辑器界面传统的IMGUI即GUI/GUILayout在性能和布局灵活性上可能成为瓶颈。Unity正在推动UI Toolkit作为新一代编辑器UI解决方案。虽然为Scene视图嵌入UI Toolkit Overlay在2022年之前的版本中较为复杂但它是未来趋势对于大型工具值得研究。6. 从工具栏到完整编辑器工具链的思考自定义工具栏只是一个起点。它的真正威力在于作为你个性化工作流的中枢。你可以以此为发射台集成更多强大功能批量处理器一个按钮批量处理选中的所有模型导入设置、或所有预制体的碰撞体生成。场景快照与切换快速保存当前场景的摄像机位置、对象状态并能一键恢复。资源检查与报告扫描项目找出未使用的资产、材质球引用丢失的模型并生成报告。与外部工具联动通过按钮触发Python脚本进行数据处理或调用命令行工具进行版本管理。我个人的体会是开发编辑器工具最大的回报不是节省的那几分钟操作时间而是思维模式的转变。你开始从“手动操作者”变为“自动化流程的设计者”。你会自然而然地思考这个重复性任务能否抽象那个易出错的操作能否通过工具校验这种能力会让你在团队中变得不可替代也是迈向技术策划或TA技术美术方向的重要基石。最后分享一个小技巧多使用[MenuItem]特性来创建顶部菜单栏的快捷方式然后将其中最常用的功能“搬运”到你的自定义工具栏上。这样你就构建了一个符合自己操作习惯的“效率仪表盘”。工具是死的工作流是活的。不断打磨你的工具链让它真正为你服务这才是学习编辑器扩展的终极目的。 
![[具身智能-649]：个人电脑搭建 RTSP 服务完整方案（Windows / Ubuntu 双平台，适配 RDK X5 rtsp2display 调试）](http://pic.xiahunao.cn/yaotu/[具身智能-649]：个人电脑搭建 RTSP 服务完整方案（Windows / Ubuntu 双平台，适配 RDK X5 rtsp2display 调试）)
