WebGPU 错误处理（Error Handling）
英文原作者：webgpufundamentals Contributors
原始链接：https://webgpufundamentals.org/webgpu/lessons/webgpu-error-handlng.html
说明：原文当前处于 TBD（待补充） 状态，仅列出了主题大纲，暂无详细正文与代码示例。以下根据大纲及 WebGPU 社区共识，对各主题进行梳理，并提炼核心优化要点与术语检查。
一、原文大纲梳理
原文列出了五个核心主题：
- Adapter/Device Creation（适配器/设备创建）
- Device Lost（设备丢失）
- Error Scopes（错误作用域）
- Shader Compilation Errors（着色器编译错误）
- Debug Labels（调试标签）
这些主题覆盖了 WebGPU 错误处理的主要场景：从设备初始化、运行时故障、局部错误捕获，到着色器编译问题及调试辅助手段。
二、核心优化要点
由于原文暂无具体实现，以下基于 WebGPU 设计理念与最佳实践提炼 3 个关键优化方向：
-
使用 Error Scopes 实现精准错误定位
在异步、多队列的 GPU 操作中，通过pushErrorScope/popErrorScope将可能出错的范围包围起来。这样可以避免一个错误影响整个命令队列，同时能快速定位出错的具体阶段（如管线创建、资源绑定或绘制调度），提升调试效率。 -
监听 Device Lost 并实现恢复机制
device.lost返回一个 Promise，在设备因严重错误、驱动崩溃或显存耗尽而丢失时解析。应在应用启动时挂接监听，记录原因（reason）与错误信息，并考虑触发资源重建或提示用户。对于长期运行的复杂 3D 应用，这一点尤为重要。 -
善用 Debug Labels 以提高 GPU 调试可读性
为缓冲区、纹理、管线、绑定组等对象设置label属性，使它们在 GPU 调试工具（如 PIX、RenderDoc 等）中显示为可读名称。这虽不直接影响运行性能，但能大幅减少定位资源泄漏、状态错误等问题的耗时，是工程化开发中的必备手段。
三、GLSL / WebGL 专业术语检查
| 英文术语 | 中文推荐 | 备注 |
|---|---|---|
| Adapter / Device Creation | 适配器 / 设备创建 | WebGPU 概念，对应 WebGL 中的上下文创建 |
| Device Lost | 设备丢失 | 类似 WebGL 的 webglcontextlost 事件 |
| Error Scopes | 错误作用域（错误范围） | WebGPU 用 pushErrorScope / popErrorScope；WebGL 中通过 getError 轮询 |
| Shader Compilation Errors | 着色器编译错误 | ⚠️ 原文写作 “shader complication errors”，应为 compilation（编译），而非 complication（复杂化） |
| Debug Labels | 调试标签 | 类似于 WebGL 的 EXT_debug_label 扩展 |
| WGSL | WebGPU 着色语言 | WebGPU 使用 WGSL，而非 GLSL；WebGL 使用 GLSL |
特别注意：
- 原文 “shader complication errors” 是笔误，正确应为 “shader compilation errors”。
- WebGPU 生态中，着色器语言为 WGSL，与 WebGL 的 GLSL 是两套不同的语言，术语不可混用。
四、核心代码保留说明
原文尚未提供任何代码示例，因此本次编译无核心代码可保留。待原文更新后，可补充 device.pushErrorScope / popErrorScope、device.lost.then()、device.createShaderModule 等典型错误处理代码片段。
