Cocos工程、编辑器与资源身份
Cocos工程包含源资产、场景、脚本、项目设置以及编辑器生成的导入缓存。理解这些对象之间的关系,才能让AI修改真正生效,避免把生成目录误当源码,或在移动文件时损坏引用。
从编辑器看到运行结构
用Creator3.8.8打开本手册的 examples/arena,在资源管理器打开 assets/scenes/Arena.scene。层级面板中的Canvas是UI节点的宿主,相机负责观察UI层,Arena组件连接纯规则与绘制。Inspector显示组件与属性;Console显示导入、编译和运行错误。
一个普通二维项目常见的节点树如下,具体拆分应服务于行为:
Scene
└─ Canvas / Camera
├─ WorldRoot 世界对象与关卡
│ ├─ Player 控制、视觉、碰撞
│ └─ Enemies 敌人实例
├─ EffectsRoot 临时效果
└─ UIRoot HUD、菜单与弹窗
教学工程用Graphics把表现集中在一个组件,便于看清规则;内容规模变大后可以拆成Prefab和独立表现组件。它展示一种明确的最小方案,并不是要求商业游戏都把对象画在同一个组件里。
哪些文件应该进版本管理
| 路径 | 作用 | 管理方式 |
|---|---|---|
| assets | 场景、脚本、图片、音频、Prefab等源资产 | 提交,并保留对应.meta |
| settings | 项目与构建相关设置 | 筛选提交团队需要的设置 |
| package.json | 项目身份、版本与脚本 | 提交 |
| library / temp | 导入、编译与临时缓存 | 可重建,通常忽略 |
| local / profiles | 本机与个人编辑状态 | 按内容区分,不提交账号秘密 |
| build | 目标平台生成产物 | 作为发布材料管理,不冒充源资产 |
.meta保存资源UUID与导入信息。场景引用通常靠UUID而不是文件名。只复制图片不复制其meta,可能产生新的资源身份;删除meta后重新导入,也可能让已有引用丢失。优先在编辑器中移动资源,提交前检查引用和差异。
Scene、Prefab与实例
Scene组织一段运行内容;Prefab保存可复用的节点与组件配置;实例是运行或编辑过程中从模板产生的具体对象。修改Prefab模板与修改某个实例的覆盖值是两件事。角色换肤、敌人波次和UI弹窗都适合评估Prefab复用。
配置引用也有加载成本。把全部敌人Prefab、关卡和纹理直接挂在启动场景,可能把它们提前带入依赖图。理解引擎的资源引用与Bundle规则,再决定预加载和延迟加载,不要仅凭文件目录判断资源何时进入内存。
构建对象必须与运行对象一致
编辑器预览不等于Web构建;Web构建不等于微信包。构建设置需要包含正确场景与启动场景,平台配置需要与目标相符。修改脚本后检查实际打开的产物时间与路径,避免浏览器仍运行旧目录。
本仓库在根目录运行 npm run cocos:web 或 npm run cocos:wechat。构建脚本先同步共享规则,再使用Creator命令行构建。Web材料进入站点的 static/cocos-arena;微信材料在教学工程的 build/wechatgame。默认游客AppID只用于教学构建。
常见故障的检查顺序
脚本存在但无效果:检查场景是否引用组件、是否启用、该场景是否为启动场景。Prefab变更没体现:检查实例覆盖与实际加载资源。移动文件后丢引用:检查meta和UUID差异。编辑器能跑、构建空白:检查资源路径、目标场景、平台API与控制台第一条异常。
请基于现有Cocos工程实现需求,不另建脱离入口的演示。
先检查启动场景、节点树、组件挂载、资源UUID与构建目标。
列出要改的源文件与生成文件,说明哪些应提交。
实现后重建目标,提供实际入口与能观察到变更的操作。
验收时从一个干净检出重新导入与构建,检查资源引用完整,生成目录可以重建,项目不依赖某台电脑的绝对资产路径。
来源与版本
核查日期2026-11-17,Creator3.8.8。