游戏引擎 / 系统课时
用预览与运行窗口确认修改是否生效
用预览与运行窗口确认修改是否生效
修改 Shader 后,编辑器预览正常不代表运行场景一定使用了同一份材质。本课建立一条从编写、保存、挂载到运行与回退的验证路径,并用一个明显变色的测试效果,快速区分代码错误、资源引用错误和运行时参数覆盖。
学习目标
- 建立 Shader 修改后可重复执行的验证顺序。
- 用明显的颜色差异核对编辑器和运行窗口。
- 按症状定位不生效原因,并安全恢复基线。
准备能一眼识别的测试效果
在 Godot 4 场景中添加带纹理的 Sprite2D,将下列完整 Shader 保存为 debug_tint.gdshader,通过节点的 Material 属性创建 ShaderMaterial 并指定该 Shader。这里保留纹理透明度,仅让不透明部分逐渐变成洋红色,便于肉眼判断。
glsl
shader_type canvas_item;
uniform float debug_mix : hint_range(0.0, 1.0, 0.1) = 0.0;
void fragment() {
// 让 0 和 1 成为清晰的验证基线。
// 不覆盖 Alpha,避免透明边缘干扰判断。
COLOR.rgb = mix(COLOR.rgb, vec3(1.0, 0.0, 1.0), debug_mix);
}预期结果:材质的 Debug Mix 为 0 时,精灵保持原样;调成 1 后,可见像素变为洋红色;调成 0.5 时呈中间效果。这是画面验证,不会产生控制台输出。
形成保存、预览和运行闭环
- 在 Shader 编辑器中确认没有编译错误,保存
.gdshader,并保存包含材质引用的场景。 - 选中目标
Sprite2D,检查Material确实指向含测试 Shader 的ShaderMaterial,而不是另一个材质。 - 在材质的
Shader Parameters中将Debug Mix设为1,观察二维编辑视口是否变成洋红色。 - 使用 Godot 4 的 运行当前场景(通常是
F6),在独立运行窗口确认同一精灵也变色;按F8停止。 - 将
Debug Mix改回0,重新运行当前场景,确认颜色恢复。只比较同一个场景、同一个节点,避免把其他场景的精灵误当测试对象。

按症状定位没有变化的原因
- 视口和运行窗口都不变色:先看 Shader 编辑器是否有错误,再确认
Sprite2D有纹理、可见且透明度不为零;检查Material下的 Shader 引用及Debug Mix是否真的为1。 - 视口变色,运行窗口不变:确认按
F6运行的是当前保存的场景;检查运行中的脚本是否重新设置材质参数、替换材质或修改节点可见性。不要把编辑器中的本地资源状态直接等同于运行时状态。 - 改了 Shader 源码却没有新效果:确认编辑的是节点实际引用的
.gdshader,且已保存;若改的是uniform默认值,还要检查材质是否保存了旧的参数覆盖值。 - 多个精灵同时变化:查看是否共用同一个
ShaderMaterial资源;需要独立参数时,为节点使用各自的材质资源。
回退到可验证的基线
调试前保存一份已确认正常的 Shader 与场景,最好纳入版本控制。若改动导致异常,先停止运行,恢复最近一次正常的源码和材质参数,再运行同一场景。不要只撤销源码却保留检查器中的异常数值。
这条验证链的通过条件是:编辑视口与运行窗口一致,修改参数能产生可预测变化,恢复参数后效果也能复原。达到这三点,才能确信本次 Shader 修改真正生效。
按自己的节奏,确认真正理解。