用途:在 three.js 场景中做调试与可视化,帮助查看坐标轴、网格、相机视锥、阴影相机、灯光方向、骨骼、包围盒以及网格法线/切线等。触发词包括 AxesHelper、GridHelper、CameraHelper、SkeletonHelper、VertexNormalsHelper,以及“辅助线”“法线显示”“包围盒调试”。
主要能力:核心 Helpers 与 Addons 中的辅助类,用于可视化相机、灯光、骨骼和几何检查信息。
使用方式:把辅助对象挂到它所描述的对象上,例如 CameraHelper(light.shadow.camera);目标移动时部分辅助需要逐帧刷新;Addons 按 threejs-dev-setup 约定从 three/addons/helpers/... 路径导入;可参考 examples/workflow-light-camera-helpers.md。
限制与注意:辅助对象是调试对象,不能当作最终场景几何或交付美术资源;生产构建中应移除或用调试开关控制;辅助会增加 draw call,排查性能问题时关闭;辅助过多会遮挡视图,建议按子系统切换;挂载父级错误会导致变换错位,可统一放在调试组下批量显隐;阴影相机辅助必须引用 light.shadow.camera 而非主视图相机。官方文档见 https://threejs.org/docs/#Helpers 与 https://threejs.org/manual/。