构建、包体、分包与缓存
级别：首作必学。平台资料核实：2026-10-31。 第一次构建用最小计数器或最小牌面工程，先确认工具链与权限，再逐步加入内容。
从 Creator 到微信工程
- 保存场景，确认构建入口场景和项目设置。
- 在 Creator 构建面板选择微信小游戏，填写自己项目的实际 AppID 与相关配置。
- 生成到独立构建目录，保留构建日志与引擎小版本。
- 用微信开发者工具打开生成目录，检查项目类型、编译与运行。
- 使用当前工具支持的预览或真机调试，记录设备、微信与基础库版本。
具体选项和平台限制按 Cocos 微信发布指南及微信当前说明核查。生成目录中的手工修改可能在下次构建被覆盖，长期设置应进入源工程或明确的构建模板。
首包只放进入游戏必需内容
首包承载启动代码、初始场景与必要资源；后续关卡和大型内容按需加载。先建立资源依赖图，避免一个被首屏引用的公共 Prefab 又牵入所有关卡素材。
Asset Bundle 是引擎资源组织方式，微信分包是平台代码包机制，两者可以协作，但不能只按文件夹名称认定已经分包。检查实际构建产物与开发者工具包体分析。
不把历史限额写进设计假设
微信当前的总包、主包、独立分包和资源文件额度，可能随政策与项目条件变化。发布前阅读官方分包说明，再检查本次构建实际大小。
wx.loadSubpackage 包含加载执行；预下载与真正加载不是同一个阶段。首版优先使用引擎支持的流程，确有需求再接底层接口。
远程资源与缓存
远程资源需要稳定地址、版本、缓存策略和下载失败处理。发布新版本时不要直接覆盖旧资源内容后又复用同一不变 URL。使用内容哈希或版本目录，让旧客户端继续拿到它理解的资源。
测试区分无缓存冷启动、已有缓存启动、更新后启动、下载中断与 CDN 失败。开发机器反复加载后的速度不能代表第一次进入的玩家。
构建记录
至少保存代码版本、配置版本、资源版本、引擎版本、AppID 所属环境、构建方式和测试结果。敏感 Secret 不进入客户端或构建日志。
完成标准：另一台干净开发环境能按记录重建；首包来源可解释；资源失败后有可恢复路径。更完整验收见真机测试。