文章目录Three.js 与前端框架集成实战Vue/React 生命周期对齐与热更新避坑一、推荐结构Renderer 单例 场景对象可替换二、Vue 侧要点三、React 侧要点四、热更新常见坑五、结语Three.js 与前端框架集成实战Vue/React 生命周期对齐与热更新避坑把 Three.js 嵌进 Vue 或 React 并不难难的是路由切换、热更新、StrictMode带来的重复初始化与资源泄漏。一、推荐结构Renderer 单例 场景对象可替换Renderer、Camera、Controls 尽量长生命周期业务模型随路由卸载时只 dispose 场景子树二、Vue 侧要点使用onBeforeUnmount统一cancelAnimationFrame、移除 resize 监听watch路由时避免重复new THREE.WebGLRenderer若用 keep-alive要在deactivated暂停渲染循环三、React 侧要点StrictMode 开发环境会双调用 effect需幂等初始化或加守卫useEffect清理函数里释放几何/材质/纹理避免在 render 阶段创建重型对象四、热更新常见坑模块热替换可能导致全局变量残留一份旧 renderer。建议把 Three 资源挂在 ref 或单例模块上并在 HMR 边界显式 dispose。五、结语框架集成本质是生命周期对齐谁创建谁销毁渲染循环与资源释放成对出现线上才稳。