8.3 调试与常见报错处理
8.3 调试与常见报错处理
本节摘要：着色器问题的排查路径是"先分层、再二分"：现象分编译错误、视觉异常、性能异常三层，每层有自己的第一问。本节把全书散落的坑收拢成一张排查表，并示范图形检查器、预览与中间输出可视化三个调试手法。
先分层，再问第一句
排查低效的根源是"一上来就乱试"。正确姿势是把现象先分三层，每层问自己的第一句不同。编译错误层（编辑器报错、材质洋红）：第一句问"错误信息的类型关键词是什么"——语法、类型还是管线（1.4 节的三分类），按关键词回图找节点。视觉异常层（能渲染但不对）：第一句问"颜色对不对、位置对不对、时机对不对"，三个维度分别对应片元计算、空间变换、时间参数三段链路。性能异常层（能跑但慢）：第一句问"CPU 还是 GPU 瓶颈"——决定是去查绘制次数还是查图本身（8.1 节的三数字）。
图：现象分层排查路径
三个调试手法
手法一：预览球当示波器。 图形检查器的预览是最低成本的断点观察：选中任意一个节点，预览窗口只显示到该节点为止的累积结果——相当于在链路中间"截图"。从数据源一路往主栈方向逐个点击，哪一步结果开始不符合预期，问题就在那一步的连线或参数上。这是图类工具独有的优势：手写着色器可没有"点哪看哪"。
手法二：中间输出可视化。 把可疑的中间值临时接到 Base Color 看颜色：标量接 Lerp 的黑白两端（灰度即数值），向量拆开逐通道看。0.5 的灰和预期不符、负数显示成纯黑、通道错位一眼可辨。这个土办法在 Custom Function 调试（7.2 节）与噪声参数验证（6.3 节）里反复出现，是着色器调试的万金油。
手法三：帧调试器定位现场。 视觉异常在"编辑器里对、场景里错"时，用帧调试器看真实的那一帧：找到问题物体的绘制调用，确认它的材质状态（关键字开关、渲染队列、混合模式）与预期一致——很多"图是对的"问题，败在材质实例的状态配置上（5.2 节 Back 剔除没设就是典型案例）。
高频问题速查表
全书正文里出现过的坑，按现象收拢成一张表，排查时先扫这里：
| 现象 | 高概率原因 | 出处章节 |
|---|---|---|
| 材质整体洋红 | 包版本错位或图编译报错 | 1.1 与 1.4 |
| 图改了场景没反应 | 忘记保存资产 | 1.2 |
| 连线显示红色 | 端口类型不匹配 | 1.2 与 1.4 |
| 边缘光中心亮边缘暗 | 忘接 One Minus | 3.1 |
| 滚动画面前后来回 | 误用 Sine Time | 4.3 与 6.1 |
| 贴图滚过头出现拉边 | 包裹模式不是 Repeat | 4.1 |
| 描边层盖住整个模型 | Render Face 没设 Back | 5.2 |
| Emission 不发光 | 后处理或泛光没开 | 2.3 与 8.2 |
| Alpha 连了却不透明 | 表面选项没设 Transparent | 2.3 与 6.2 |
| 溶解进度多物体互串 | 共享材质未实例化 | 6.4 |
| 顶点动画看不出效果 | 网格密度不足 | 6.5 |
| 特定操作后掉帧尖峰 | 冷门变体即时编译 | 7.3 |
💡 排查的时间分配经验：一半以上的"着色器 bug"最终不在图里，而在材质实例状态、管线资源开关或资产配置上。先扫速查表，再进图逐节点二分，最后才怀疑算法本身——顺序反了会做大量无用功。
二分断链的完整操作
把 8.3 节提到的二分法展开成可执行步骤：第一步，把可疑链路从中点断开，断点靠主栈一侧接一个固定常量（黑色或中间灰），保存观察现象是否消失；第二步，现象消失则问题在断点后半段，未消失则在逻辑上前半段（常量替换了后半段的输入，后半段仍在跑，判断时注意这一点）；第三步，对锁定的一半继续从中点断开，重复。每次保存确认一次，五到七次二分可以把问题定位到单节点。整个过程十分钟上下，比逐节点排查快一个数量级。
问题：报错信息指向的行号在图里找不到对应？
生成代码的行号与图没有直接映射（1.4 节的编译链决定），行号只对 Custom Function 的代码段有意义。处理办法：从报错的类型关键词出发（无法转换、未定义标识符、重定义），在图里搜索对应的结构特征——类型错找类型突变的连线，未定义找管线专属节点。把行号当线索而不是当地址，就不会陷入"按行号找节点"的死胡同。
排查记录的价值
最后给一个被低估的习惯：把每次排查记三行——现象、原因、解法。三个月后这个记录就是项目的专属排错手册，其命中率远高于任何通用教程（包括本书）。团队场景下，排查记录还能反向推动规范：同一类问题出现三次，就该写进团队约定从源头杜绝。调试水平的成长曲线，取决于记录与复盘的密度，而不是踩坑的绝对数量。
视觉异常的三维定位法补充
"颜色、位置、时机"三维定位值得各给一个示范问句。颜色维度问：错误的颜色是整体偏差（查色彩空间与光照）还是局部错误（查那条具体链路）？位置维度问：错位是固定的（查空间与坐标）还是漂移的（查时间项混入）？时机维度问：该动的不动（查时间链断开）、不该动的乱动（查时间项误接）还是节奏不对（查频率系数）？三个维度的问句把"效果不对"这个模糊描述拆成可操作的排查分支——模糊症状的第一步永远是拆解，拆完才知道往哪查。
问题：改好了但复现不出来，之前的错还在吗？
着色器没有持久状态，"偶发"的问题通常是环境组合问题：特定的材质状态加特定的场景配置才触发。复现不出来的正确处理不是"先不管"，而是记录触发时的完整环境（材质参数截图、场景状态描述），下次同类现象出现时对照。8.3 节反复强调的排查记录在这里补上第三重价值：单次记录是解法，积累的记录是模式库——模式库越厚，"偶发"问题越少，因为多数偶发只是你还认不出的模式。
本节要点回顾
- 先分层再排查：编译、视觉、性能三层，每层有专属第一问。
- 预览即断点：点选节点看累积结果，是图类工具独有的调试红利。
- 中间值可视化：可疑数值接颜色输出，灰度即读数，万金油手法。
- 速查表先行：一半问题出在图外，先扫表再进图。
至此，画得出、算得清、查得动——效果工程的闭环完成。最后一章把视线抬起来：Shader Graph 在整个工具生态里站在哪，你的下一步往哪走。