从性能症状定位 CPU、GPU 与批次
适用:Cocos Creator 3.8.8 + TypeScript,分析方法引擎无关。资料核查:2026-11-17。Cocos 的原生 Profiler 与浏览器统计面板是不同工具,本节不把原生能力假定为微信能力,未做设备性能实测。
先有假设,再开面板
“卡”可能来自持续 CPU 负载、GPU 像素压力、资源准备、垃圾回收或网络状态停顿。记录它出现的具体阶段和触发条件,再选择工具。若打开界面时卡一次,先抓这一小段;若敌人增加后持续慢,比较不同敌人数;若画面平滑但角色响应迟缓,可能是输入或网络流程,不应只盯着渲染。
一份有效的性能录制包含稳定起点、短而明确的操作和已知结束点。录制整段十分钟随机游玩会产生大量噪声,也难比较修改前后。先在浏览器定位共享脚本热点,再在微信对应工具与真机验证同类问题;不同环境的绝对耗时不能直接当作等价数据。
区分统计面板与完整剖析器
Cocos 可通过 profiler.showStats() 显示常见运行统计,适合观察帧率与批次趋势。官方“性能剖析器”章节描述的更细原生统计有平台范围限制,不能照其 C++ 宏示例期待微信出现同样数据。浏览器可用 DevTools Performance 查看主线程任务与调用栈;微信则使用当前开发者工具和设备可用的诊断能力,记录实际支持项。
import { profiler } from 'cc';
export function setDebugStats(enabled: boolean) {
if (enabled) profiler.showStats();
else profiler.hideStats();
}
统计面板适合发现“切到某 UI 后批次上升”,但不能单凭它判断 GPU 耗时。JavaScript 函数运行短,也可能因提交大量图形工作而让 GPU 忙;反之 GPU 等待也可能是 CPU 没及时提交。不要用 Date.now 包住一段渲染调用就宣称测到完整 GPU 时间。渲染流水涉及异步执行,需要工具提供的对应证据。
CPU 分析看总量与调用路径
调用树的 inclusive 时间包含子调用,self 时间更接近函数自身消耗。某个调度函数耗时最高可能只是承载所有业务,不是应该重写的热点。沿最重路径找到可解释的工作,再看每帧调用次数和输入规模。一次调用很快但每帧几千次,同样可能占满预算;偶尔一次昂贵初始化则应调整时机或拆分工作。
常见 CPU 问题包括每帧遍历整棵节点树查组件、频繁创建临时数组、对全部敌人做全对全距离检测、逐帧改动不变的 UI、反复更新文字与布局。优先减少不必要工作和数据规模,再考虑缓存与池化。缓存需要失效策略,不能为了省查找长期持有已销毁节点。对象池也要重置状态,否则性能改进会引入行为错误。
为了验证因果,可暂时关闭一个明确子系统,观察是否显著改善;再恢复它并做针对性修改。临时关闭只用于诊断,不能作为最终方案。算法由平方级降到空间划分后的近邻检测,通常比无依据地把 forEach 换成 for 循环更值得检查,但也要用实际负载验证索引维护成本。
GPU 压力不仅来自 DrawCall
二维游戏也可能因大量透明重叠、全屏特效、大粒子、过高渲染分辨率而消耗大量像素处理。保持实体数量不变,降低渲染分辨率或关闭覆盖范围大的效果,若帧时间明显改善,可支持像素压力假设,但还需对应工具证据。小图很多与一张全屏透明图的成本不同,不能只统计三角形数量。
DrawCall 较高则检查相邻渲染对象的纹理、材质、采样与渲染状态,以及节点顺序和遮罩。Cocos 2D 合批有明确条件,把图片放进同一图集只是其中之一。每个角色创建独立材质实例,可能破坏预期合批;随意重排节点虽然降低批次,也可能改变正确遮挡。先保留视觉顺序,再寻找可合并的连续区域。
图集、文字与遮罩各有取舍
静态图集提前打包,通常更可控;动态合图在运行时处理,可能减少部分批次,也会增加内存与初始化成本,并与图像缓存清理策略相关。不能将“开启动态合图”作为所有微信项目的默认优化。先在实际目标配置下对比,确认批次减少的收益超过额外资源成本。
文字是常见隐形热点。分数变化时才更新标签,避免每帧重复写同一字符串;选择字体与缓存模式时结合字符集合和变化频率。大量独立文字、嵌套遮罩和特殊材质交错,可能使 UI 批次碎片化。按展示区域组织节点,减少不必要遮罩,同时检查裁剪正确性,不要只看批次数字。
一次优化需要一条证据链
记录症状、假设、采样、修改、复测与副作用。例如“弹出背包后长帧增加;录制显示大量同步创建;分批实例化可见行后,打开时长帧下降,但总完成时间略增”。这比“优化了渲染”更能让后来者理解取舍。若修改前后流程或设备不同,结果只能作为线索,不能作为确定结论。
每次只处理一个主要瓶颈;它消失后下一个瓶颈可能显现。避免同时改图集、物理、池化和字体,最后无法知道哪个有效。性能录制也可能包含日志、截图和数据,保存前考虑敏感内容,并按产物标识归档,不能随手覆盖最后一份可复现证据。
统计工具自身也会改变负载
统计面板、性能录制、详细日志与远程调试都需要资源。先用足够信息定位,再在接近发布条件下关闭额外诊断验证。显示统计的代码应在引擎初始化后调用,例如场景已启动的调试入口,不能随意在模块加载最早阶段访问尚未建立的渲染对象。
若一次优化只在开着某种工具时有效,检查它是否减少了日志或采样开销,而非真实游戏工作。报告保存采样方式与开关,能避免不同工具条件下数字被错误比较。关键结论最好同时有趋势证据和具体热点解释,两者能互相校验。
交给 AI 的任务与验收
可复制任务:“针对峰值战斗卡顿提出三个可证伪假设,分别说明 CPU、像素压力和批次问题如何采样。只实现最有证据的一项优化,保留修改前后同流程记录。明确 Cocos 原生 Profiler 不代表微信可用,不把 JS 墙钟时间称为 GPU 时间。”
验收热点能关联到具体调用与规模;关闭诊断变量能支持或否定假设;最终优化不改变遮挡、碰撞和输入;发布条件复测仍有改善。资源趋势异常则继续内存与加载排查。
官方来源
- Cocos 3.8.8 Profiler 源码:showStats/hideStats 的精确补丁版本依据。
- Cocos 3.8 原生性能剖析器:明确原生平台范围。
- Cocos 3.8 2D 合批规则与动态合图:批次条件与资源取舍。
- Chrome Performance:浏览器调用栈与录制方法;微信效果须另外验证。