从Unity WebGL切换到Three.js,最大的变化不是编程语言,而是把场景从引擎托管转为组件化渲染。Unity导出到Web时会把运行时和资源打包成大型wasm与data文件,React只能通过iframe或插件方式嵌入,通信笨重。Three.js则天然运行在WebGL上下文,与React状态同步更直接,可以直接在组件树中管理3D对象。

此外迁移后可以减少首屏体积,配合glTF压缩、懒加载和CDN,首屏时间可以从十几秒缩短到两秒以内。下文从资源转换、场景搭建、性能优化三个角度展开。
一、先处理资源格式转换与场景拆分
Unity的AssetBundle不能直接在Three.js中使用,模型需要统一成glTF或GLB格式。FBX、OBJ可以借助Blender或转换工具批量转成glTF,贴图建议压缩为KTX2或WebP。Unity中的Shader和材质系统与Three.js不兼容,半透明、顶点色、法线贴图需要重新调整;动画可以用glTF内嵌或单独文件加载。
Unity场景通常是一个完整关卡,迁移时应该按物体类型或区域拆分成多个GLB文件,而不是导出单个巨型文件。这样可以利用React的代码分割和动态import实现按需加载。例如使用原生Three.js加载一个模型文件,可以这样写:
import * as THREE from 'three';
import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
const loader = new GLTFLoader();
loader.load('/models/scene.glb', function(gltf) {
const model = gltf.scene;
model.scale.set(2, 2, 2);
scene.add(model);
}, undefined, function(error) {
console.error('模型加载失败', error);
});
原生方式适合做加载器底层封装,但在React中直接操作scene和renderer会破坏组件生命周期。因此更推荐使用react-three-fiber,它把场景图映射为React组件,让资源加载和卸载都符合React的心智模型。
二、在React中重建交互与动画循环
react-three-fiber把Three.js的场景图变成React组件树,每个mesh、group都是组件。不需要手动管理requestAnimationFrame和清理资源。状态更新可以触发重新渲染,但要注意不要把高频数据放到React state里,应该用ref和useFrame处理每帧更新。useFrame相当于Unity里的Update方法,会在每一帧执行,适合旋转、缩放、相机跟随等操作。
交互方面,Unity的碰撞检测和射线由引擎内部处理,Three.js需要手动射线检测或借助drei的辅助组件。点击、悬停事件可以绑定在mesh上,事件对象包含交点信息。下面是一个可旋转、点击变色的3D盒子组件示例:
import { Canvas, useFrame } from '@react-three/fiber';
import { useRef, useState } from 'react';
function Box(props) {
const meshRef = useRef();
const [active, setActive] = useState(false);
useFrame(function(state, delta) {
meshRef.current.rotation.x += delta;
meshRef.current.rotation.y += delta * 0.5;
});
function handleClick() {
setActive(!active);
}
return (
<mesh
ref={meshRef}
scale={active ? 1.5 : 1}
onClick={handleClick}
>
<boxGeometry args={[1, 1, 1]} />
<meshStandardMaterial color={active ? '#ff6080' : '#4ea1ff'} />
</mesh>
);
}
export default function App() {
return (
<Canvas>
<ambientLight intensity={0.5} />
<pointLight position={[10, 10, 10]} />
<Box />
</Canvas>
);
}
这个组件把3D对象的旋转状态放在ref中,避免每帧触发React渲染;点击状态放在useState中,因为点击频率低,触发一次渲染完全可以接受。如果从Unity迁移时保留了类似的交互逻辑,可以把原来的Update方法体迁移到useFrame中,把OnMouseDown等事件迁移到对应的事件回调。
三、性能优化与内存管理
迁移后性能瓶颈主要在draw call和纹理内存。Unity会自动合批,Three.js需要手动合并几何体或使用InstancedMesh。复杂场景可以做LOD,远处物体用低模。纹理压缩推荐KTX2和Basis Universal,几何压缩用DRACO,但DRACO需要在worker中解码避免阻塞主线程。这些压缩方案能显著减小模型体积,但会在首次加载时增加少量CPU消耗。
内存管理上,需要监听组件卸载时调用dispose释放geometry和material,删除纹理。否则反复切换场景会导致显存泄漏。React的useEffect cleanup很适合处理。示例:
import { useEffect } from 'react';
import { useLoader } from '@react-three/fiber';
import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
function Model({ url }) {
const gltf = useLoader(GLTFLoader, url, function(loader) {
const dracoLoader = new DRACOLoader();
dracoLoader.setDecoderPath('/draco/');
loader.setDRACOLoader(dracoLoader);
});
useEffect(function() {
return function() {
gltf.scene.traverse(function(child) {
if (child.isMesh) {
child.geometry.dispose();
if (Array.isArray(child.material)) {
child.material.forEach(function(m) {
m.dispose();
});
} else {
child.material.dispose();
}
}
});
};
}, [gltf]);
return <primitive object={gltf.scene} />;
}
加载策略上,可以使用React.lazy和Suspense包裹3D组件,实现按需加载;对模型文件设置缓存头部,利用HTTP缓存减少重复请求。同时在加载过程中展示进度条,使用THREE.LoadingManager统一管理多个资源的加载状态。这些手段叠加后,首屏体积往往只有Unity WebGL方案的十分之一。
从Unity迁移到Three.js并不是推倒重来,而是把已经做好的3D资产重新组织到Web友好的渲染管线中。只要处理好资源格式、组件化场景和内存释放,就能在React中获得更轻量、更可控的3D体验。