6大调试组件详解Vertx.Debugging可视化碰撞与触发器事件【免费下载链接】Vertx.DebuggingDebugging utilities for Unity项目地址: https://gitcode.com/gh_mirrors/ve/Vertx.DebuggingVertx.Debugging是一款面向 Unity 的可视化调试工具包版本 3.0.2支持 Unity 2022.2它使用实例化渲染Instanced Rendering高效绘制线框形状让物理碰撞、触发器事件、边界框等看不见的逻辑在 Scene 视图中一目了然。对于新手来说它内置了6 个开箱即用的调试组件挂上即可用无需手写 Gizmos 代码。为什么需要可视化调试Unity 物理引擎中的碰撞点、触发器区域、法线方向都是纯数据肉眼无法观察。传统做法是手写Gizmos.DrawWireSphere之类的代码繁琐且性能差。Vertx.Debugging 把这些工作封装成了组件只需在Add Component → Debugging菜单中找到它们 提示需要在 Scene 视图顶部开启Gizmos开关才能看到绘制内容。6大调试组件一览#组件源码位置作用1Debug TransformRuntime/Components/DebugTransform.cs绘制 Transform 的 up / right / forward 三轴方向2Debug Renderer BoundsRuntime/Components/DebugRendererBounds.cs绘制 Renderer 的包围盒Bounds3Debug Collider BoundsRuntime/Components/DebugColliderBounds.cs绘制 Collider 或 Collider2D 的包围盒4Debug Collision EventsRuntime/Components/DebugCollisionEvents.cs可视化 OnCollisionEnter / Stay / Exit 碰撞事件5Debug Trigger EventsRuntime/Components/DebugTriggerEvents.cs可视化 OnTriggerEnter / Stay / Exit 触发器事件6Debug Mesh NormalsRuntime/Components/DebugMeshNormals.cs绘制网格Mesh的所有法线方向快速上手一键添加调试组件以最常用的碰撞事件可视化为例只需三步打开 Package Manager添加包名com.vertx.debugging通过 OpenUPM 源选中场景中任意带 Collider 的物体点击Add Component → Debugging → Debug Collision Events。完成后每次碰撞发生时场景中就会在接触点位置画出一个带方向的小圆圈SurfacePoint直观显示碰撞位置与法线方向——调物理参数再也不靠猜常用参数速查Enter / Stay / Exit三种事件可分别勾选开关并为每种事件单独设置颜色和持续时长Duration颜色语义Enter 默认绿色、Stay 默认黄色、Exit 默认红色见Runtime/Shapes/Shapes.Parameters.cs中的Shape.EnterColor等常量Draw Only When Selected基类Runtime/Components/DebugComponentBase.cs提供的全局开关开启后只有选中物体时才绘制避免大量物体同屏时画面杂乱所有事件组件都标记了[ExecuteAlways]因此编辑器暂停状态下手动调用Physics.Simulate也能看到可视化效果。各组件核心功能详解1️⃣ Debug Transform —— 方向轴可视化为物体绘制 XYZ 方向轴Axis 形状支持调整Scale缩放比例并通过Shape.Axes枚举选择只显示 X、Y、Z 中的某几个轴。排查物体朝向不对旋转轴理解错误这类问题时有奇效。2️⃣ Debug Renderer Bounds —— 渲染包围盒自动获取自身的 Renderer 并绘制其bounds包围盒颜色可自定义。适合检查渲染体大小是否符合预期、判断 LOD 切换范围等。3️⃣ Debug Collider Bounds —— 碰撞包围盒同时支持 3D 的Collider和 2D 的Collider2D2D 支持为可选项绘制物理包围盒。当看起来能碰到但实际没碰到时用它对比渲染体与碰撞体边界差异问题立刻现形。4️⃣ Debug Collision Events —— 碰撞事件可视化组件内部实现了OnCollisionEnter / Stay / Exit以及 2D 版本遍历每一次碰撞的所有ContactPoint在每个接触点画出法线方向指示。3D 使用 SurfacePoint射线圆环2D 使用 Arrow2D 箭头表示。5️⃣ Debug Trigger Events —— 触发器事件可视化与碰撞组件对应实现了OnTriggerEnter / Stay / Exit含 2D 版本直接绘制触发者碰撞体的 Bounds并以不同颜色区分进出状态。调试拾取区域、伤害范围、传送触发器时必不可少。6️⃣ Debug Mesh Normals —— 网格法线可视化要求物体上有MeshFilter[RequireComponent]自动添加以RayLength参数控制法线射线长度将模型每个顶点的法线画出来。法线错误是模型背面显示、光照诡异最常见的原因这个组件是排查利器。进阶在代码中绘制物理结果除了组件项目还提供了DrawPhysics/DrawPhysics2D两个与原生Physics/Physics2DAPI 完全一致的替代类源码见Runtime/DrawPhysics.cs、Runtime/DrawPhysics2D.cs。只需把调用前缀一换射线、球形、箱形、胶囊形投射Raycast / SphereCast / BoxCast / CapsuleCast的执行路径与命中结果就会自动画出来。常见问题 FAQQ看不到任何绘制内容确认 Scene 视图顶部已开启 Gizmos若使用了仅选中时绘制请先选中物体。QGame 视图中出现深度异常、穿透显示这是 Unity 自身的已知 Bug可在Project Settings → Vertx → Debugging中关闭对应视图的 Depth Write / Depth Test 解决配置代码见Runtime/Settings/DebuggingSettings.cs。Q打包发布时这些调试代码会被包含吗不会。D.raw等绘制调用在构建时会被自动剥离Code Stripping无需手动删除或添加宏定义。Q支持 2D 项目吗支持。2D 物理为可选模块项目使用 Physics2D 时碰撞、触发器、包围盒组件会自动启用 2D 事件回调。Q支持从 Job / Burst 中绘制吗支持文本除外。若 Job 由FixedUpdate调度需调用DrawPhysicsUtility.GetFixedFrameJobDuration获取帧率修正后的时长避免闪烁。总结Vertx.Debugging 用 6 个零配置组件 高性能实例化渲染把 Unity 物理调试中最头疼的看不见的逻辑变成了看得见的画面Debug Transform方向轴可视化Debug Renderer/Collider Bounds包围盒对比排查Debug Collision/Trigger Events碰撞与触发事件全记录Debug Mesh Normals法线问题一秒定位新手只需挂载组件即可立刻受益进阶用户还可以用DrawPhysics替换原生物理调用或在扩展程序集中自定义新形状Shape是 partial 类实现IDrawable接口即可。让物理调试从此告别盲调。【免费下载链接】Vertx.DebuggingDebugging utilities for Unity项目地址: https://gitcode.com/gh_mirrors/ve/Vertx.Debugging创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考