示例工程【免费下载链接】Unity3DTraining【Unity杂货铺】unity大杂烩~项目地址https://gitcode.com/gh_mirrors/un/Unity3DTraining点击查看免费下载导读Unity3DTraining仓库的 GizmoKitCollection.md 是一份面向 Unity 开发者的Gizmos 拓展工具清单集中收录了社区中若干成熟的 Gizmos 增强方案。本文以这份清单为主体逐项解读这些工具的能力边界与适用场景并回到仓库内部用 DrawCircle.cs、DebugUILine.cs、SpringBoneEditor.cs 三份真实源码演示手写 Gizmos的典型套路。读完本文你将掌握原生 Gizmos 的能力与局限、6 类社区拓展工具的分工、如何用Gizmos.matrix与Handles完成复杂场景可视化以及接入第三方工具前的评估要点。一、为什么需要 Gizmos 拓展工具Unity 内置的Gizmos静态类提供了一组仅在 Scene 视图与调试状态下生效的绘制 API是日常开发中可视化碰撞体、触发器、路径点、攻击范围最直接的手段。其核心入口是 MonoBehaviour 上的两个回调OnDrawGizmos()每帧都会绘制在编辑器与运行时Game 视图均可生效OnDrawGizmosSelected()仅当对象被选中时绘制适合层级较多时的选择性显示。原生 API 虽然简单但存在两个明显短板图元种类有限只提供DrawLine、DrawCube、DrawSphere、DrawWireCube、DrawWireSphere、DrawMesh、DrawIcon等基础能力没有圆环、扇形、箭头、多边形、文本标签等游戏开发中的高频图形默认不进入运行时构建内置 Gizmos 是调试设施发布后的 Player 中默认不可见若需要在真实设备上展示调试信息如 AI 感知范围、网络路径就必须自行扩展。正是这两个缺口催生了社区里一大批Gizmos 拓展工具而 GizmoKitCollection.md 正是 UnityEditorExtension/README.md 中收集整理一些 Gizmos 相关工具这一条目指向的专用清单见该 README 的编辑器拓展列表部分。二、文档收集的 6 个 Gizmos 拓展工具逐一解读GizmoKitCollection.md 正文以清单形式收录了 6 个工具原文为外部链接形式此处按工具名与定位归纳工具来源/作者定位据链接命名与说明推断典型适用场景UnityToolsCaptainHillmanUnity 编辑器工具合集需要一套打包好的通用编辑器增强能力SensorKitUWA 实验室传感器/感知范围类可视化工具AI 视野、听觉、感知半径调试unitilitieschristianchomiakUnity 开发工具集合日常开发中多种小工具的聚合Unity3d Gizmo Mesh Previeweditkid在 Gizmos 中预览网格(Mesh)在场景视图中直接预览网格模型Gizmo ExtensionsUWA 实验室Gizmos 绘制能力的扩展集合补齐原生 API 缺失的图元popcron/gizmospopcron运行时与编辑器双端绘制 Gizmos构建版本内保留调试可视化结合工具命名与清单来源可以给出如下选型建议具体能力边界需以各工具仓库内的文档为准追求开箱即用、不想维护代码优先考察UnityTools与unitilities这类工具合集它们通常直接以.unitypackage或源码目录方式导入需要 AI/传感器范围可视化SensorKit的定位高度契合可避免手写扇形、锥体等复杂的 Gizmos 数学需要场景内预览美术模型Unity3d Gizmo Mesh Preview专注 Mesh 预览适合资产检查与摆放调试需要在发布版本中保留调试绘制原生 Gizmos 在构建后默认失效popcron/gizmos明确宣称支持drawing runtime gizmos in builds and editor这类场景应优先选它希望只补图元、不引入重框架Gizmo Extensions作为扩展集合更轻量可结合下文第三节的仓库示例自行评估其实现思路。事实边界说明除链接标题自带的描述外上述工具的具体接口、版本与性能细节本文不作展开以免以讹传讹接入前请以各工具仓库 README 与更新记录为准。三、仓库内的 Gizmos 实战示例三种典型编写形态在引入第三方库之前先理解原生 Gizmos 的三种典型编写形态能帮助你更准确地判断哪些该自己写、哪些该用现成工具。Unity3DTraining仓库恰好提供了三个互不重复的范本。3.1 用Gizmos.matrixDrawLine绘制圆环SomeTest/GizmosDrawCircle 是一个独立的 Unity 练习工程其核心脚本 DrawCircle.cs 展示了如何用折线段逼近一个平滑圆环void OnDrawGizmos() { if (m_Transform null) return; if (m_Theta 0.0001f) m_Theta 0.0001f; // 设置矩阵让绘制坐标跟随物体本地坐标系 Matrix4x4 defaultMatrix Gizmos.matrix; Gizmos.matrix m_Transform.localToWorldMatrix; // 设置颜色 Color defaultColor Gizmos.color; Gizmos.color m_Color; // 按角度步进绘制线段逼近圆环 Vector3 beginPoint Vector3.zero; Vector3 firstPoint Vector3.zero; for (float theta 0; theta 2 * Mathf.PI; theta m_Theta) { float x m_Radius * Mathf.Cos(theta); float z m_Radius * Mathf.Sin(theta); Vector3 endPoint new Vector3(x, 0, z); if (theta 0) firstPoint endPoint; else Gizmos.DrawLine(beginPoint, endPoint); beginPoint endPoint; } Gizmos.DrawLine(firstPoint, beginPoint); // 闭合首尾 // 恢复默认颜色与矩阵 Gizmos.color defaultColor; Gizmos.matrix defaultMatrix; }这份代码关键逻辑位于 DrawCircle.cs 的OnDrawGizmos约 18–57 行包含三个值得复用的技巧角度步进参数m_Theta控制平滑度值越低采样点越多、圆越平滑但每帧绘制的线段数也越多需要注意性能与视觉效果的平衡代码里m_Theta 0.0001f的钳制用于防止除零/死循环风险Gizmos.matrix m_Transform.localToWorldMatrix将整个绘制坐标系切换到物体的本地空间之后(x, 0, z)的坐标会自动随物体的位移、旋转、缩放而变换实现圆环挂在物体上的效果保存/恢复现场先Gizmos.matrix/Gizmos.color保存默认值绘制结束后还原避免污染同一帧内其他组件的 Gizmos 绘制。对照上文原生无圆环的短板这正是社区Gizmo Extensions一类工具所做的事情——把这类几何逼近代码封装成Gizmos.DrawCircle(...)式的便捷 API。3.2 遍历场景绘制 UGUI 射线检测区域SomeTest/UnityEditorTest/DebugUILine.cs 是另一个方向用 Gizmos 做整场景的 UI 调试可视化。它通过#if UNITY_EDITOR限定仅在编辑器编译遍历所有可射线检测的MaskableGraphic用RectTransform.GetWorldCorners取世界坐标四角后连线成矩形static Vector3[] fourCorners new Vector3[4]; void OnDrawGizmos() { foreach (MaskableGraphic g in GameObject.FindObjectsOfTypeMaskableGraphic()) { if (g.raycastTarget) { RectTransform rectTransform g.transform as RectTransform; rectTransform.GetWorldCorners(fourCorners); Gizmos.color Color.blue; for (int i 0; i 4; i) Gizmos.DrawLine(fourCorners[i], fourCorners[(i 1) % 4]); } } }要点解析静态复用数组fourCorners声明为static避免每帧分配新数组是 Gizmos 场景中控制 GC 的典型手法GetWorldCorners返回世界坐标配合Gizmos.DrawLine直接绘制世界空间线段无需再处理矩阵变换以真实可点击区域为目标只绘制raycastTarget true的图元让策划/美术直观看到哪些 UI 区域真正响应点击这是把 Gizmos 用作团队协作检查工具的好例子。3.3 用Handles做出可交互手柄编辑器拓展进阶Gizmos 只能画UnityEditor.Handles则能交互。DynamicBones/SpringBone/Assets/Editor/SpringBoneEditor.cs 的OnSceneGUI约 33–46 行展示了完整套路private void OnSceneGUI() { var t target as SpringBone; var so new SerializedObject(t); Handles.DrawDottedLine(t.transform.position, t.transform.TransformPoint(t.springEnd), 4.0f); var currentPos t.transform.TransformPoint(t.springEnd); var size HandleUtility.GetHandleSize(currentPos) * 0.2f; EditorGUI.BeginChangeCheck(); var movedPos Handles.FreeMoveHandle(currentPos, Quaternion.identity, size, Vector3.one * 0.5f, Handles.SphereHandleCap); if (EditorGUI.EndChangeCheck()) { so.FindProperty(springEnd).vector3Value t.transform.InverseTransformPoint(movedPos); so.ApplyModifiedProperties(); } }这里出现了三个进阶 API均是社区编辑器拓展工具的常见底层实现Handles.DrawDottedLine绘制虚线适合表现弹簧末端到骨骼这类辅助连线Handles.FreeMoveHandleHandleUtility.GetHandleSize在场景视图中生成一个可拖拽的小球手柄GetHandleSize让手柄大小随视口缩放自适应EditorGUI.BeginChangeCheck()/EndChangeCheck()配合SerializedObject与ApplyModifiedProperties()把拖拽结果安全写回序列化属性并支持 Undo。从源码结构看本仓库的SpringBone演示工程是把运行时物理模拟DynamicBones与编辑器可视化手柄结合的范例也印证了社区工具清单中UnityTools、Gizmo Extensions等合集的内部实现往往正是GizmosHandles的组合。四、接入第三方 Gizmos 工具前的评估清单结合第二节的工具定位与第三节的原生能力边界接入前建议按以下维度核对编辑器/运行时双端需求只在开发期调试原生GizmosOnDrawGizmos足够需要发布版本内可视化如线上问题排查、AI 行为演示则应选popcron/gizmos这类明确支持 builds 内绘制的方案Unity 版本与渲染管线兼容性工具若直接操纵Gizmos.matrix或依赖Handles在较新 Unity 版本如 2021与 SRP 管线下的行为可能有差异导入前应核对仓库更新记录性能与 GCGizmos 每帧执行优先选择复用静态数组、避免每帧new的写法可对照 DebugUILine.cs 的static数组作用域隔离第三方工具绘制时是否保存/恢复Gizmos.color与Gizmos.matrix会影响同一场景其他组件的可视化是否正确对照 DrawCircle.cs 的现场恢复写法许可证与依赖合集类工具往往夹带大量无关代码优先考虑按需抽取避免污染工程。五、小结GizmoKitCollection.md 是仓库维护者沉淀的一份Gizmos 拓展工具导航覆盖了工具合集UnityTools、unitilities、感知可视化SensorKit、网格预览Gizmo Mesh Preview、图元扩展Gizmo Extensions与运行时绘制popcron/gizmos五个方向仓库自身则提供了三条手写 Gizmos的完整实践链路几何逼近圆环DrawCircle.cs、全场景 UI 区域可视化DebugUILine.cs、可拖拽编辑器手柄SpringBoneEditor.cs建议的落地路径是先用仓库内示例摸清原生Gizmos/Handles的能力边界再按第四节清单对照选择第三方工具避免为单一功能引入重量级框架。赞分享示例工程【免费下载链接】Unity3DTraining【Unity杂货铺】unity大杂烩~项目地址https://gitcode.com/gh_mirrors/un/Unity3DTraining点击查看免费下载相关推荐Unity运行时编辑器RuntimeUnityEditor实时调试与场景编辑的完整指南Unity运行时编辑器RuntimeUnityEditor实时调试与场景编辑的完整指南 RuntimeUnityEditor是一款专为Unity3D引擎设计的如何打造终极智能家居控制中心Home Assistant仪表盘设计完全指南如何打造终极智能家居控制中心Home Assistant仪表盘设计完全指南 想要创建一个既美观又实用的智能家居控制界面吗Home Assistant多房间管物联网Unity MCP 工具完全参考从场景搭建到性能剖析的 AI 驱动 Unity 编辑器自动化实战指南Unity MCP 工具完全参考从场景搭建到性能剖析的 AI 驱动 Unity 编辑器自动化实战指南 本指南以 Unity MCPModel ContextMCP 服务AI 应用游戏开发工具调用上一篇Qwen3技术架构全景解读六大突破性创新如何重新定义大语言模型效能标准下一篇性能炸裂阿里QwQ-32B模型深度测评小参数如何比肩671B大模型创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Unity Gizmos 拓展工具集收集与实战指南：从调试可视化到场景编辑利器
示例工程【免费下载链接】Unity3DTraining【Unity杂货铺】unity大杂烩~项目地址https://gitcode.com/gh_mirrors/un/Unity3DTraining点击查看免费下载导读Unity3DTraining仓库的 GizmoKitCollection.md 是一份面向 Unity 开发者的Gizmos 拓展工具清单集中收录了社区中若干成熟的 Gizmos 增强方案。本文以这份清单为主体逐项解读这些工具的能力边界与适用场景并回到仓库内部用 DrawCircle.cs、DebugUILine.cs、SpringBoneEditor.cs 三份真实源码演示手写 Gizmos的典型套路。读完本文你将掌握原生 Gizmos 的能力与局限、6 类社区拓展工具的分工、如何用Gizmos.matrix与Handles完成复杂场景可视化以及接入第三方工具前的评估要点。一、为什么需要 Gizmos 拓展工具Unity 内置的Gizmos静态类提供了一组仅在 Scene 视图与调试状态下生效的绘制 API是日常开发中可视化碰撞体、触发器、路径点、攻击范围最直接的手段。其核心入口是 MonoBehaviour 上的两个回调OnDrawGizmos()每帧都会绘制在编辑器与运行时Game 视图均可生效OnDrawGizmosSelected()仅当对象被选中时绘制适合层级较多时的选择性显示。原生 API 虽然简单但存在两个明显短板图元种类有限只提供DrawLine、DrawCube、DrawSphere、DrawWireCube、DrawWireSphere、DrawMesh、DrawIcon等基础能力没有圆环、扇形、箭头、多边形、文本标签等游戏开发中的高频图形默认不进入运行时构建内置 Gizmos 是调试设施发布后的 Player 中默认不可见若需要在真实设备上展示调试信息如 AI 感知范围、网络路径就必须自行扩展。正是这两个缺口催生了社区里一大批Gizmos 拓展工具而 GizmoKitCollection.md 正是 UnityEditorExtension/README.md 中收集整理一些 Gizmos 相关工具这一条目指向的专用清单见该 README 的编辑器拓展列表部分。二、文档收集的 6 个 Gizmos 拓展工具逐一解读GizmoKitCollection.md 正文以清单形式收录了 6 个工具原文为外部链接形式此处按工具名与定位归纳工具来源/作者定位据链接命名与说明推断典型适用场景UnityToolsCaptainHillmanUnity 编辑器工具合集需要一套打包好的通用编辑器增强能力SensorKitUWA 实验室传感器/感知范围类可视化工具AI 视野、听觉、感知半径调试unitilitieschristianchomiakUnity 开发工具集合日常开发中多种小工具的聚合Unity3d Gizmo Mesh Previeweditkid在 Gizmos 中预览网格(Mesh)在场景视图中直接预览网格模型Gizmo ExtensionsUWA 实验室Gizmos 绘制能力的扩展集合补齐原生 API 缺失的图元popcron/gizmospopcron运行时与编辑器双端绘制 Gizmos构建版本内保留调试可视化结合工具命名与清单来源可以给出如下选型建议具体能力边界需以各工具仓库内的文档为准追求开箱即用、不想维护代码优先考察UnityTools与unitilities这类工具合集它们通常直接以.unitypackage或源码目录方式导入需要 AI/传感器范围可视化SensorKit的定位高度契合可避免手写扇形、锥体等复杂的 Gizmos 数学需要场景内预览美术模型Unity3d Gizmo Mesh Preview专注 Mesh 预览适合资产检查与摆放调试需要在发布版本中保留调试绘制原生 Gizmos 在构建后默认失效popcron/gizmos明确宣称支持drawing runtime gizmos in builds and editor这类场景应优先选它希望只补图元、不引入重框架Gizmo Extensions作为扩展集合更轻量可结合下文第三节的仓库示例自行评估其实现思路。事实边界说明除链接标题自带的描述外上述工具的具体接口、版本与性能细节本文不作展开以免以讹传讹接入前请以各工具仓库 README 与更新记录为准。三、仓库内的 Gizmos 实战示例三种典型编写形态在引入第三方库之前先理解原生 Gizmos 的三种典型编写形态能帮助你更准确地判断哪些该自己写、哪些该用现成工具。Unity3DTraining仓库恰好提供了三个互不重复的范本。3.1 用Gizmos.matrixDrawLine绘制圆环SomeTest/GizmosDrawCircle 是一个独立的 Unity 练习工程其核心脚本 DrawCircle.cs 展示了如何用折线段逼近一个平滑圆环void OnDrawGizmos() { if (m_Transform null) return; if (m_Theta 0.0001f) m_Theta 0.0001f; // 设置矩阵让绘制坐标跟随物体本地坐标系 Matrix4x4 defaultMatrix Gizmos.matrix; Gizmos.matrix m_Transform.localToWorldMatrix; // 设置颜色 Color defaultColor Gizmos.color; Gizmos.color m_Color; // 按角度步进绘制线段逼近圆环 Vector3 beginPoint Vector3.zero; Vector3 firstPoint Vector3.zero; for (float theta 0; theta 2 * Mathf.PI; theta m_Theta) { float x m_Radius * Mathf.Cos(theta); float z m_Radius * Mathf.Sin(theta); Vector3 endPoint new Vector3(x, 0, z); if (theta 0) firstPoint endPoint; else Gizmos.DrawLine(beginPoint, endPoint); beginPoint endPoint; } Gizmos.DrawLine(firstPoint, beginPoint); // 闭合首尾 // 恢复默认颜色与矩阵 Gizmos.color defaultColor; Gizmos.matrix defaultMatrix; }这份代码关键逻辑位于 DrawCircle.cs 的OnDrawGizmos约 18–57 行包含三个值得复用的技巧角度步进参数m_Theta控制平滑度值越低采样点越多、圆越平滑但每帧绘制的线段数也越多需要注意性能与视觉效果的平衡代码里m_Theta 0.0001f的钳制用于防止除零/死循环风险Gizmos.matrix m_Transform.localToWorldMatrix将整个绘制坐标系切换到物体的本地空间之后(x, 0, z)的坐标会自动随物体的位移、旋转、缩放而变换实现圆环挂在物体上的效果保存/恢复现场先Gizmos.matrix/Gizmos.color保存默认值绘制结束后还原避免污染同一帧内其他组件的 Gizmos 绘制。对照上文原生无圆环的短板这正是社区Gizmo Extensions一类工具所做的事情——把这类几何逼近代码封装成Gizmos.DrawCircle(...)式的便捷 API。3.2 遍历场景绘制 UGUI 射线检测区域SomeTest/UnityEditorTest/DebugUILine.cs 是另一个方向用 Gizmos 做整场景的 UI 调试可视化。它通过#if UNITY_EDITOR限定仅在编辑器编译遍历所有可射线检测的MaskableGraphic用RectTransform.GetWorldCorners取世界坐标四角后连线成矩形static Vector3[] fourCorners new Vector3[4]; void OnDrawGizmos() { foreach (MaskableGraphic g in GameObject.FindObjectsOfTypeMaskableGraphic()) { if (g.raycastTarget) { RectTransform rectTransform g.transform as RectTransform; rectTransform.GetWorldCorners(fourCorners); Gizmos.color Color.blue; for (int i 0; i 4; i) Gizmos.DrawLine(fourCorners[i], fourCorners[(i 1) % 4]); } } }要点解析静态复用数组fourCorners声明为static避免每帧分配新数组是 Gizmos 场景中控制 GC 的典型手法GetWorldCorners返回世界坐标配合Gizmos.DrawLine直接绘制世界空间线段无需再处理矩阵变换以真实可点击区域为目标只绘制raycastTarget true的图元让策划/美术直观看到哪些 UI 区域真正响应点击这是把 Gizmos 用作团队协作检查工具的好例子。3.3 用Handles做出可交互手柄编辑器拓展进阶Gizmos 只能画UnityEditor.Handles则能交互。DynamicBones/SpringBone/Assets/Editor/SpringBoneEditor.cs 的OnSceneGUI约 33–46 行展示了完整套路private void OnSceneGUI() { var t target as SpringBone; var so new SerializedObject(t); Handles.DrawDottedLine(t.transform.position, t.transform.TransformPoint(t.springEnd), 4.0f); var currentPos t.transform.TransformPoint(t.springEnd); var size HandleUtility.GetHandleSize(currentPos) * 0.2f; EditorGUI.BeginChangeCheck(); var movedPos Handles.FreeMoveHandle(currentPos, Quaternion.identity, size, Vector3.one * 0.5f, Handles.SphereHandleCap); if (EditorGUI.EndChangeCheck()) { so.FindProperty(springEnd).vector3Value t.transform.InverseTransformPoint(movedPos); so.ApplyModifiedProperties(); } }这里出现了三个进阶 API均是社区编辑器拓展工具的常见底层实现Handles.DrawDottedLine绘制虚线适合表现弹簧末端到骨骼这类辅助连线Handles.FreeMoveHandleHandleUtility.GetHandleSize在场景视图中生成一个可拖拽的小球手柄GetHandleSize让手柄大小随视口缩放自适应EditorGUI.BeginChangeCheck()/EndChangeCheck()配合SerializedObject与ApplyModifiedProperties()把拖拽结果安全写回序列化属性并支持 Undo。从源码结构看本仓库的SpringBone演示工程是把运行时物理模拟DynamicBones与编辑器可视化手柄结合的范例也印证了社区工具清单中UnityTools、Gizmo Extensions等合集的内部实现往往正是GizmosHandles的组合。四、接入第三方 Gizmos 工具前的评估清单结合第二节的工具定位与第三节的原生能力边界接入前建议按以下维度核对编辑器/运行时双端需求只在开发期调试原生GizmosOnDrawGizmos足够需要发布版本内可视化如线上问题排查、AI 行为演示则应选popcron/gizmos这类明确支持 builds 内绘制的方案Unity 版本与渲染管线兼容性工具若直接操纵Gizmos.matrix或依赖Handles在较新 Unity 版本如 2021与 SRP 管线下的行为可能有差异导入前应核对仓库更新记录性能与 GCGizmos 每帧执行优先选择复用静态数组、避免每帧new的写法可对照 DebugUILine.cs 的static数组作用域隔离第三方工具绘制时是否保存/恢复Gizmos.color与Gizmos.matrix会影响同一场景其他组件的可视化是否正确对照 DrawCircle.cs 的现场恢复写法许可证与依赖合集类工具往往夹带大量无关代码优先考虑按需抽取避免污染工程。五、小结GizmoKitCollection.md 是仓库维护者沉淀的一份Gizmos 拓展工具导航覆盖了工具合集UnityTools、unitilities、感知可视化SensorKit、网格预览Gizmo Mesh Preview、图元扩展Gizmo Extensions与运行时绘制popcron/gizmos五个方向仓库自身则提供了三条手写 Gizmos的完整实践链路几何逼近圆环DrawCircle.cs、全场景 UI 区域可视化DebugUILine.cs、可拖拽编辑器手柄SpringBoneEditor.cs建议的落地路径是先用仓库内示例摸清原生Gizmos/Handles的能力边界再按第四节清单对照选择第三方工具避免为单一功能引入重量级框架。赞分享示例工程【免费下载链接】Unity3DTraining【Unity杂货铺】unity大杂烩~项目地址https://gitcode.com/gh_mirrors/un/Unity3DTraining点击查看免费下载相关推荐Unity运行时编辑器RuntimeUnityEditor实时调试与场景编辑的完整指南Unity运行时编辑器RuntimeUnityEditor实时调试与场景编辑的完整指南 RuntimeUnityEditor是一款专为Unity3D引擎设计的如何打造终极智能家居控制中心Home Assistant仪表盘设计完全指南如何打造终极智能家居控制中心Home Assistant仪表盘设计完全指南 想要创建一个既美观又实用的智能家居控制界面吗Home Assistant多房间管物联网Unity MCP 工具完全参考从场景搭建到性能剖析的 AI 驱动 Unity 编辑器自动化实战指南Unity MCP 工具完全参考从场景搭建到性能剖析的 AI 驱动 Unity 编辑器自动化实战指南 本指南以 Unity MCPModel ContextMCP 服务AI 应用游戏开发工具调用上一篇Qwen3技术架构全景解读六大突破性创新如何重新定义大语言模型效能标准下一篇性能炸裂阿里QwQ-32B模型深度测评小参数如何比肩671B大模型创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考