游戏引擎 / 系统课时
动态加载一个游戏 Prefab
动态加载一个游戏 Prefab
当敌人、宝箱或场景道具只在需要时出现,直接把所有 Prefab 拖进场景会增加初始资源负担。本课以一个 3D 箱子为例,完成从资源路径到异步加载、实例化、挂入场景与结果验证的整条链路,并处理加载期间场景已退出的情况。
学习目标
- 正确准备
resources目录下的 Prefab 与加载路径。 - 使用
resources.load和instantiate在场景中生成节点。 - 在异步回调中检查失败和组件生命周期,避免无效场景操作。
准备 Prefab 与生成位置
在 Cocos Creator 3.8 中创建一个带立方体模型的节点,根节点命名为 Crate,将它保存为 assets/resources/prefabs/Crate.prefab。如果 resources 目录不存在,先在 assets 下创建它。
打开用于预览的 3D 场景,创建空节点 SpawnPoint,把它放在摄像机可见的位置。稍后将脚本挂在 SpawnPoint 上,实例就会成为它的子节点。要看到立方体,还须确认场景有可用摄像机、模型渲染器和合适的光照或材质。
resources.load 接收的是相对于 assets/resources 的路径,因此这里应写 prefabs/Crate,不要写 assets/resources/prefabs/Crate.prefab。Prefab 类型参数用于明确加载的资源类型。
加载并实例化
创建 TypeScript 脚本 SpawnCrate.ts,内容如下。将脚本挂载到 SpawnPoint,启动场景后由 start 发起一次加载。
import { _decorator, Component, Prefab, instantiate, isValid, resources } from 'cc';
const { ccclass } = _decorator;
@ccclass('SpawnCrate')
export class SpawnCrate extends Component {
start(): void {
resources.load('prefabs/Crate', Prefab, (err, prefab) => {
if (err || !prefab) {
console.error('Prefab 加载失败:', err);
return;
}
// 加载期间可能已切走场景,或禁用了挂载组件
if (!isValid(this, true) || !this.enabledInHierarchy) {
return;
}
// Prefab 是模板,instantiate 才会创建独立 Node
const crate = instantiate(prefab);
this.node.addChild(crate);
crate.setPosition(0, 0, 0);
console.log('生成完成:', crate.name);
});
}
}预期输出(Prefab 根节点命名为 Crate):
生成完成: Crate层级管理器中应能看到 SpawnPoint 下新增的 Crate 节点;场景画面在相机和可见性设置正确时显示该立方体。setPosition(0, 0, 0) 是相对 SpawnPoint 的局部坐标,不是固定世界原点。首次加载结束的时刻取决于缓存和设备,不应假设它在调用 resources.load 后立刻完成。
回调与场景生命周期
异步加载可以看作两条相互独立的时间线:资源系统负责找到并准备 Prefab,游戏场景中的发起者可能同时被禁用、销毁或切换。只有在回调返回成功,且当前组件仍能使用时,才能安全地将实例放入场景。

示例把有效性检查放在回调内,而不是 start 中,因为风险发生在等待加载的过程中。isValid(this, true) 能识别当帧已请求销毁的对象;enabledInHierarchy 用于避免组件停用后仍往场景中添加内容。本示例选择丢弃过期结果,不在重新启用时自动重试。
用故障现象反查步骤
如果控制台出现加载失败,先核对 Prefab 是否真的位于 assets/resources/prefabs/Crate.prefab、文件名大小写是否一致,以及加载参数是否省略扩展名。文件存在但路径写错时,resources.load 不会自动搜索整个项目。
如果输出“生成完成”但画面没有立方体,应先展开节点层级,确认实例是否创建,再检查 SpawnPoint 的世界位置、模型组件、节点激活状态、摄像机朝向与裁剪距离。已经生成节点却看不见,通常不是资源加载接口的问题。
如果切换场景后没有生成对象,则可能是有效性检查主动跳过了过期回调,这正是预期保护行为。若将加载函数改为按键触发,要额外控制重复点击,否则多次成功回调会创建多个实例。
分清节点销毁和资源释放
instantiate(prefab) 生成的是场景 Node;以后调用该 Node 的 destroy() 或销毁其父节点,会移除对应实例,但不代表 Asset Manager 缓存中的 Prefab 已经被释放。需要长期复用时,让资源继续缓存通常更合适。
当一个模块确定不再使用某份资源时,再根据引用关系考虑释放;不要在刚实例化成功后就无条件 assetManager.releaseAsset(prefab),以免它的依赖仍被活动节点使用。至此,一个可靠的动态生成过程应同时满足三点:路径可解析、回调后才使用模板、实例只挂到仍有效的场景节点上。