# 游戏性能问题复现模板

版本：2026-09-08
来源：GameStart Studio（https://www.gamestartstudio.cn）

> 用途：在处理卡顿、内存、包体、崩溃或构建问题前，固定复现条件并保留测量证据。没有统一设备、版本、场景和指标的前后对比，不能可靠判断优化是否有效。

## 1. 问题基本信息

- 项目名称：
- 问题编号：
- 首次发现日期：
- 报告人：
- 当前负责人：
- 严重程度：阻塞上线 / 严重影响 / 一般问题 / 优化建议
- 问题类型：帧率 / 卡顿 / 内存 / 发热 / 包体 / 启动 / 崩溃 / 构建 / 其他
- 影响范围：全部用户 / 特定设备 / 特定场景 / 偶发
- 目标解决日期：

## 2. 版本与构建基线

- 引擎名称与精确版本：
- Git 提交、分支或版本号：
- 构建日期：
- 构建方式：Development / Release
- 脚本后端：Mono / IL2CPP
- 图形 API：
- 渲染器、渲染管线与图形 API（按当前引擎填写）：
- 质量等级与帧率设置：
- 是否开启调试日志或分析器：
- 最近一次正常版本：

## 3. 测试设备与环境

| 项目               | 记录 |
| ------------------ | ---- |
| 设备型号           |      |
| CPU / GPU          |      |
| 内存容量           |      |
| 操作系统版本       |      |
| 屏幕分辨率与刷新率 |      |
| 网络环境           |      |
| 电量与温度状态     |      |
| 后台应用状态       |      |
| 安装方式           |      |

## 4. 稳定复现步骤

前置条件：

1.
2.

操作步骤：

1.
2.
3.

- 预期结果：
- 实际结果：
- 复现次数：
- 成功复现次数：
- 复现概率：
- 从启动到出现问题的时间：
- 退出场景或重启后是否恢复：

## 5. 指标与证据

| 指标                 | 目标值 | 当前值 | 测量工具 | 测量区间 |
| -------------------- | ------ | ------ | -------- | -------- |
| 平均帧率或帧时间     |        |        |          |          |
| 主线程耗时           |        |        |          |          |
| 渲染线程耗时         |        |        |          |          |
| Draw Calls / Batches |        |        |          |          |
| 总内存与峰值         |        |        |          |          |
| GC Alloc             |        |        |          |          |
| 启动或加载时间       |        |        |          |          |
| 安装包或下载体积     |        |        |          |          |

已收集证据：

- [ ] 当前引擎对应的性能分析数据
- [ ] Memory Profiler 快照
- [ ] Frame Debugger 或 GPU 分析数据
- [ ] 系统性能、温度或功耗记录
- [ ] 崩溃堆栈与完整日志
- [ ] 构建日志与错误信息
- [ ] 问题录屏或截图
- [ ] 正常版本与异常版本对比

证据文件位置：

## 6. 初步定位

- 主要耗时或异常模块：
- 是否与资源加载相关：
- 是否与 GC 或内存释放相关：
- 是否与渲染、Shader 或特效相关：
- 是否与网络或第三方 SDK 相关：
- 是否与设备、系统或驱动相关：
- 是否与最近代码或资源变更相关：
- 当前假设：
- 仍需验证的假设：

## 7. 修复与验证记录

| 日期 | 改动内容 | 对应版本 | 指标变化 | 副作用 | 结论 |
| ---- | -------- | -------- | -------- | ------ | ---- |
|      |          |          |          |        |      |

每次验证必须保持一致：

- [ ] 使用同一设备和系统版本
- [ ] 使用同一场景、操作路径和测试时长
- [ ] 使用同一质量、分辨率和帧率设置
- [ ] 清楚标注冷启动、热启动或缓存状态
- [ ] 至少重复测试并记录波动范围
- [ ] 检查优化是否引入功能或画面回归

## 8. 验收结论

- [ ] 已达到约定目标，可以关闭
- [ ] 有明显改善，但仍需继续优化
- [ ] 已提供可接受的规避方案
- [ ] 受设备、架构或第三方限制，无法达到原目标
- [ ] 尚未稳定复现，继续收集证据

- 最终测试版本：
- 最终测试设备：
- 修复前结果：
- 修复后结果：
- 剩余风险：
- 后续监控方式：
- 验收人：
- 验收日期：