路线阶段：Unity WebGL 小游戏实战第 13 章。
本章目标：解决“一个人能做、多人就混乱”的问题，让项目进入可规模化协作状态。
学习目标
完成本章后，你应该能做到：
- 设计适合小团队的分支与提交流程。
- 建立资源、配置、代码三类变更的门禁策略。
- 用自动化检查拦截常见回归（缺资源、错引用、性能超限）。
- 让策划与程序协同迭代更稳定。
常见协作灾难
- Prefab 冲突频发，合并成本高。
- 配置改动没有评审，线上活动直接出错。
- 临时资源未归档，构建时丢失引用。
- 提测无标准，测试环境经常“不可玩”。
分支模型建议
main：仅稳定可发布版本。develop：集成分支。feature/*：功能开发。content/*：活动与关卡配置。hotfix/*：线上修复。
规则：
- 禁止直推
main。 - 所有 PR 必须附构建结果和关键截图。
content/*也要走 PR 评审。
资源规范
命名规则
- 场景：
SC_Stage01_Main - 预制体：
PF_Enemy_Melee_A - 材质：
MAT_UI_Button_Primary - 纹理：
TX_Stage01_Tile_01
目录规则
Assets/Game/Runtime：运行时代码Assets/Game/Content/Stages：关卡配置Assets/Game/Art/UI：UI资源Assets/Game/Art/VFX：特效资源
配置变更门禁
public static class ContentGate
{
public static int ValidateAll()
{
var errors = new List<string>();
errors.AddRange(StageConfigGate.Check());
errors.AddRange(EventConfigGate.Check());
errors.AddRange(EconomyConfigGate.Check());
if (errors.Count > 0)
{
for (var i = 0; i < errors.Count; i++)
{
UnityEngine.Debug.LogError(errors[i]);
}
return 1;
}
UnityEngine.Debug.Log("ContentGate pass");
return 0;
}
}CI 在构建前执行，失败即阻断。
自动化质量门禁
最小门禁组合：
- 配置校验
- 关键关卡冒烟测试
- WebGL 构建可用性检查
- 性能预算校验（压测场景）
PR 模板建议
每个 PR 必填：
- 改动范围（代码/配置/资源）
- 风险点
- 自测清单
- 回滚方案
提测清单
发测试环境前至少验证：
- 首关可进可通关。
- 关键活动可打开与领奖。
- 广告位成功/失败流程可走通。
- 低配模式与 WebGL 焦点恢复正常。
回归分层
P0：无法进入游戏、核心流程中断。P1：经济错误、奖励发放异常。P2：表现问题、轻度体验问题。
线上修复优先级按 P0 > P1 > P2 执行。
与前面系统联动
- 配置管线：纳入 content gate。
- 埋点体系：PR 后比对关键指标变化。
- 性能系统：门禁自动读取基线阈值。
- 发布运维：提测通过后进入灰度流程。
WebGL 注意点
- 资源路径大小写要严格一致。
- 构建脚本和模板改动必须有回归验证。
- CDN 缓存策略变更需单独评审。
验收清单
- 至少一个完整功能通过 PR 门禁进入
develop。 - 配置错误可在 CI 中被明确拦截。
- 提测版本具备统一校验报告。
- 回归问题可追踪到具体变更和责任边界。
常见坑
坑 1：把资源规范当“建议”
长期会形成不可维护资产。必须自动化检查并阻断。
坑 2：内容改动不走评审
活动与经济配置错误的风险不低于代码错误。
坑 3：只做功能验证不做回滚演练
出问题时止损慢。每个高风险改动都要有回滚路径。
本月作业
建立一套“提测机器人”流程：
- 自动执行配置校验 + 构建 + 冒烟。
- 生成提测报告（通过项/失败项/耗时）。
- 将结果回写到 PR 讨论区。
下一章进入 Unity WebGL 小游戏实战 14：安全与反作弊基础（客户端可信边界与异常检测）。