游戏引擎 / 系统课时

按用途整理项目资源

按用途整理项目资源

场景、脚本、图片和音频不断增加后,随意堆放资源会让预制体难以定位、文件重名,也会提高迁移时丢失引用的风险。本篇以 Cocos Creator 3.8 的小型二维游戏为例,建立容易扩展的目录约定,并验证静态引用与运行时加载都能正常工作。

学习目标

  • 为场景、脚本、预制体、贴图、动画和音频划分清楚的存放位置。
  • 识别普通资源目录与特殊 resources 目录的职责差异。
  • 在移动文件后保护 .meta 引用,并验证一条动态加载路径。

先按资源职责划分主目录

Cocos Creator 的项目资源放在 assets 下;build、library 等项目级目录不是手工整理游戏素材的地方。开始时让每种资源有明确归属,目录不要为了对称而提前建立大量空层级。

资源类型 建议位置 典型内容
场景 assets/scenes/ Menu.scene、Game.scene
脚本 assets/scripts/ player/PlayerController.ts、ui/HudView.ts
预制体 assets/prefabs/ Player.prefab、Hud.prefab
贴图与图集 assets/textures/ ui/、characters/ 内的图片与图集
动画 assets/animations/ 角色移动、攻击和 UI 过渡动画
音频 assets/audio/ music/、sfx/ 中的音乐和音效

这是一种组织约定,并不是引擎强制要求的目录名称。先按资源类型区分,再在资源多起来时按功能细分。例如 scripts/player/ 与 textures/characters/ 分别承载角色逻辑和角色图片,不必把同一个角色的所有文件强行放在一个文件夹。

区分静态引用和路径加载

放在普通目录的 Hud.prefab 可以直接拖入场景或组件属性,通过编辑器序列化引用使用。只有需要通过 resources.load() 按路径加载的资源,才放入 assets/resources/ 或其子目录。不要把所有素材搬进 resources:其中的资源及关联依赖可能一并进入构建包,影响体积与资源剔除。

例如需要在关卡中按需生成金币,可把 Coin.prefab 放在 assets/resources/prefabs/。加载路径是 prefabs/Coin,相对于 resources,且不带 .prefab 扩展名。普通的 assets/prefabs/Hud.prefab 不会因为写了同名字符串就被 resources.load() 找到。

普通资源与动态加载目录的层级关系

在资源管理器中执行一次整理

  1. 先提交版本或备份项目,再在编辑器的“资源管理器”面板选中 assets,通过创建文件夹操作建立需要的目录。
  2. 在资源管理器中移动现有场景、脚本和预制体,优先使用编辑器完成重命名与移动,观察引用是否仍然正常。
  3. 用统一命名区分用途:脚本名对应职责,预制体名对应可复用对象,音频放入 music 或 sfx;避免 new、final2 之类无法说明内容的名称。
  4. 搜索脚本中的硬编码资源路径。编辑器移动资源可以保留 UUID 引用,但 resources.load('旧路径') 这类字符串不会自动随文件移动而改写。

每份导入资源都有对应的 .meta 文件,用来保存 UUID 和导入配置。不要只在系统文件管理器中移动原文件、丢下 .meta;更不要通过编辑 library 内的生成文件整理素材。多人协作时应把相关 .meta 一同纳入版本控制。

用最小脚本验证加载约定

先在 assets/resources/prefabs/ 中准备一个可实例化的 Coin.prefab,在当前场景添加一个空节点并挂上 ResourcePathCheck.ts。下面是运行于 Cocos Creator 项目中的完整组件:

ts
import { _decorator, Component, Prefab, instantiate, resources } from 'cc';
const { ccclass } = _decorator;

@ccclass('ResourcePathCheck')
export class ResourcePathCheck extends Component {
  start(): void {
    // 路径相对 assets/resources,不能包含 prefab 文件扩展名
    resources.load('prefabs/Coin', Prefab, (err, prefab) => {
      if (err || !prefab) {
        console.error('[资源检查] 加载失败:prefabs/Coin', err);
        return;
      }

      // 成功后实例化并放入当前节点,便于层级面板验证
      const coin = instantiate(prefab);
      this.node.addChild(coin);
      console.log('[资源检查] 加载成功:prefabs/Coin');
    });
  }
}

预期输出:预览运行后,控制台打印以下内容,挂载脚本的节点下新增一个金币实例。

text
[资源检查] 加载成功:prefabs/Coin

如果显示加载失败,优先检查实际目录、大小写、资源类型与扩展名是否遗漏删除;不要用磁盘绝对路径替代引擎资源路径。若脚本成功加载却看不到金币,还要检查实例的坐标、父节点与 UI 层级,这已不是目录定位错误。

用可维护性检验目录设计

完成整理后,从 Game.scene 能快速找到玩家脚本、场景 UI 和音效;移动一个预制体不应打断属性面板中的 UUID 引用;调整按路径加载的资源后,相关字符串也已同步更新。预览菜单和游戏场景,并至少运行一次实际使用的资源加载流程。

当资源规模较大且需要独立下载、分包或按模块更新时,再考虑 Asset Bundle;小型项目先把上述目录和命名规范执行一致,比一次性建立很深的层级更有效。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

按用途整理项目资源

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通