在使用 @react-three/drei 的 CameraControls 时，可通过 enableZoom={false} 精准禁用鼠标滚轮缩放（dolly），同时保留平移、旋转等其他交互能力，避免误设 dollySpeed={0} 或 mouseButtons 导致交互完全失效。
在使用 @react-three/drei 的 cameracontrols 时，可通过 `enablezoom={false}` 精准禁用鼠标滚轮缩放（dolly），同时保留平移、旋转等其他交互能力，避免误设 `dollyspeed={0}` 或 `mousebuttons` 导致交互完全失效。
在 Three.js + React 项目中，CameraControls 是一个功能强大且高度可配置的相机控制组件，但其 API 中部分属性的行为容易被误解。例如，将 dollySpeed 设为 0 并不能“仅禁用缩放”，而是会干扰底层输入事件处理逻辑，导致整个滚轮事件在控件区域内被静默丢弃——这正是你在 Jupiter 组件中遇到的问题：行星区域滚动时既不缩放，也无法触发页面默认滚动或自定义响应。
✅ 正确做法是使用官方支持的布尔控制属性：
<cameracontrols ref="{cameraControlsRef}" enablezoom="{false}" dolly pan></cameracontrols>
该属性会直接禁用 dollyIn() / dollyOut() 的响应逻辑，但保留 truck, rotate, fitToBox 等所有其他功能。你仍可通过 cameraControlsRef.current.zoomTo(...) 在代码中主动控制缩放级别（如 useEffect 中的 zoom() 调用依然有效）。
⚠️ 注意事项：
-
enableZoom={false}不影响键盘快捷键（如+/−）——若需一并禁用，请配合keyboardEnabled={false}或自定义keyMap； - 若同时禁用了
enableZoom和enableRotate，建议显式启用enablePan={true}以维持基础平移能力； -
mouseButtons属性仅用于重映射按键行为（如将右键改为旋转），不能用于禁用某类操作；它不接收null或false值，错误配置反而可能导致意外行为。
? 小技巧：你还可以结合 minZoom 和 maxZoom 实现“缩放范围锁定”，例如：
<cameracontrols enablezoom="{true}" minzoom="{2.5}" maxzoom="{2.5}" smoothtime="{0.2}"></cameracontrols>
此时用户仍可滚动，但相机实际缩放值被强制钳制，视觉上等效于禁用缩放——适用于需要保留滚动反馈但禁止视角变化的场景。
综上，enableZoom={false} 是语义清晰、零副作用、符合 Drei 最佳实践的标准解法，应作为禁用 dolly 的首选方案。
