调试与性能分析

从一个可推翻的运行假设开始

“调试与性能分析”先固定一个问题：如何证明用调试回调、帧捕获与GPU计时定位首个错误事件？先写下预期对象、状态或像素，再运行正常基线；若debug message、对象标签、捕获事件、资源快照与GPU时间戳不能指出第一个分叉，最终画面看起来正确也不能通过。

本页不变量是：调试与性能分析的输入、状态、输出与恢复结果可用同一证据包重放。故障模式“只在帧尾调用glGetError，或用CPU墙钟时间替代GPU查询”每次只改变一个条件，正常、故障、恢复三次运行必须共享输入与版本。

来源、版本与课程边界

“调试与性能分析”不是某本同名原书的翻译，也不把四套API规范拼成虚构目录。OpenGL状态与对象语义以OpenGL 4.6 Core规范核对，着色语言以GLSL 4.60规范核对，移动端与浏览器边界分别以OpenGL ES 3.2规范和WebGL 2规范核对。八个正式单元是独立课程分类。

六个检查词

在“调试与性能分析”的六词核对中，glgeterror、khr_debug、renderdoc、profil、state ownership、binding。术语只有进入公式、交互状态、代码和可重放输出，才算真正覆盖。

正式单元与机制解释

Debugging and GPU Profiling

在“调试与性能分析”的“Debugging and GPU Profiling”检查中，glGetError只提供有限错误队列且可能扰动热路径；KHR_debug能携带source、type、severity与对象标签。在“调试与性能分析”的“Debugging and GPU Profiling”检查中，RenderDoc或Spector帧捕获展示资源和命令状态，timer query则把GPU区间与CPU提交时间分开。

在“调试与性能分析”本页，正式坐标是glgeterror、khr_debug、renderdoc、profil。在“调试与性能分析”的反例核对中，反事实为“只在帧尾调用glGetError，或用CPU墙钟时间替代GPU查询”；应从debug message、对象标签、捕获事件、资源快照与GPU时间戳找到第一个分叉。

先预测，再操作三个章专属实验

最小可重现实验

glEnable(GL_DEBUG_OUTPUT);
glDebugMessageCallback(debugCallback, nullptr);
glBeginQuery(GL_TIME_ELAPSED, query);
drawPass();
glEndQuery(GL_TIME_ELAPSED);

运行“调试与性能分析”时记录API/规范版本、设备或浏览器能力、固定输入、关键中间状态与输出摘要。不得用一次漂亮截图替代对象合同、验证消息、时间戳或像素差异。

练习与答案

本章回顾

掌握“调试与性能分析”意味着能把“用调试回调、帧捕获与GPU计时定位首个错误事件”落到具体对象、状态与输出，能制造“只在帧尾调用glGetError，或用CPU墙钟时间替代GPU查询”，还能凭debug message、对象标签、捕获事件、资源快照与GPU时间戳恢复同输入结果。

阅读导航

← 跨平台兼容性 · FBO 与后处理技术 →