Web 图形与 3D / 系统课时
编译 GLSL 着色器并链接程序
编译 GLSL 着色器并链接程序
把顶点与片元两段 GLSL ES 3.00 源码变成真正可使用的 WebGLProgram,需要分别编译 Shader,再将它们附加到 Program 并链接。本课完成后,你可以独立检查编译、链接和绑定结果,并为下一步传入顶点数据做好准备。
学习目标
- 写出符合 WebGL 2 规范的最小顶点着色器和片元着色器。
- 使用编译、链接及状态查询 API 创建可绑定的 Program。
- 通过信息日志定位失败,并正确处理 Shader 与 Program 的生命周期。
两段 GLSL ES 3.00 源码
WebGL 2 使用 GLSL ES 3.00。两段源码都必须以 #version 300 es 开始;版本指令放在字符串第一行,不要在它前面插入空行或注释。
顶点着色器通过 layout(location = 0) in vec2 a_position; 接收二维坐标,在 main() 中将其扩展成 vec4(x, y, 0.0, 1.0) 并写入 gl_Position。这里使用裁剪空间坐标,后续向槽位 0 提供顶点数据即可。
片元着色器声明 precision mediump float; 与 out vec4 outColor;,在 main() 中输出 vec4(0.1, 0.6, 0.9, 1.0),四个分量依次为红、绿、蓝和不透明度。GLSL ES 3.00 不再使用旧版的 attribute、varying 和 gl_FragColor 写法。
编译与链接的先后关系
WebGLShader 是单个阶段的编译对象;WebGLProgram 则组合顶点和片元阶段。每段源码编译成功,不代表两段之间一定能链接,例如顶点输出与片元输入的变量类型不匹配时,链接仍可能失败。

实际调用顺序如下:
- 对两种类型分别调用
createShader、shaderSource、compileShader,用getShaderParameter(shader, gl.COMPILE_STATUS)判断各自是否编译成功;失败时读取getShaderInfoLog。 - 通过
createProgram创建容器,调用两次attachShader,然后linkProgram;用getProgramParameter(program, gl.LINK_STATUS)判断链接是否成功,失败时读取getProgramInfoLog。 - 对成功的 Program 调用
useProgram;通过getParameter(gl.CURRENT_PROGRAM)检查当前绑定。链接成功后可分离并删除阶段性 Shader,对应的 Program 仍可用于绘制。
在浏览器中完成一次编译与链接
在支持 WebGL 2 的浏览器中打开空白页面,按 F12 进入开发者工具的 Console,粘贴并运行下面的完整 JavaScript。示例创建一张 480×270 的画布,不依赖第三方库;GLSL 写在 JavaScript 模板字符串中,因此 #version 必须紧贴字符串开头。
(() => {
const canvas = document.createElement("canvas");
canvas.width = 480;
canvas.height = 270;
canvas.style.border = "1px solid #94a3b8";
document.body.appendChild(canvas);
const gl = canvas.getContext("webgl2");
if (!gl) throw new Error("无法创建 WebGL 2 上下文");
const vertexSource = `#version 300 es
layout(location = 0) in vec2 a_position;
void main() {
gl_Position = vec4(a_position, 0.0, 1.0);
}`;
const fragmentSource = `#version 300 es
precision mediump float;
out vec4 outColor;
void main() {
outColor = vec4(0.1, 0.6, 0.9, 1.0);
}`;
function compileShader(type, source) {
const shader = gl.createShader(type);
if (!shader) throw new Error("创建 Shader 失败");
gl.shaderSource(shader, source);
gl.compileShader(shader);
if (!gl.getShaderParameter(shader, gl.COMPILE_STATUS)) {
const log = gl.getShaderInfoLog(shader) || "无编译日志";
gl.deleteShader(shader);
throw new Error(`Shader 编译失败:${log}`);
}
return shader;
}
let vertexShader = null;
let fragmentShader = null;
let program = null;
try {
vertexShader = compileShader(gl.VERTEX_SHADER, vertexSource);
fragmentShader = compileShader(gl.FRAGMENT_SHADER, fragmentSource);
program = gl.createProgram();
if (!program) throw new Error("创建 Program 失败");
gl.attachShader(program, vertexShader);
gl.attachShader(program, fragmentShader);
gl.linkProgram(program);
if (!gl.getProgramParameter(program, gl.LINK_STATUS)) {
throw new Error(`Program 链接失败:${gl.getProgramInfoLog(program) || "无链接日志"}`);
}
console.log("顶点编译:", gl.getShaderParameter(vertexShader, gl.COMPILE_STATUS));
console.log("片元编译:", gl.getShaderParameter(fragmentShader, gl.COMPILE_STATUS));
console.log("程序链接:", gl.getProgramParameter(program, gl.LINK_STATUS));
// 已链接的程序可以脱离阶段性 Shader 继续使用
gl.detachShader(program, vertexShader);
gl.detachShader(program, fragmentShader);
gl.useProgram(program);
console.log("当前 Program 正确:", gl.getParameter(gl.CURRENT_PROGRAM) === program);
console.log("a_position 槽位:", gl.getAttribLocation(program, "a_position"));
// 保留 Program,下一步可以继续绑定缓冲区并绘制
window.webglDemo = { canvas, gl, program };
} catch (error) {
if (program) gl.deleteProgram(program);
throw error;
} finally {
if (vertexShader) gl.deleteShader(vertexShader);
if (fragmentShader) gl.deleteShader(fragmentShader);
}
})();预期输出(浏览器控制台):
顶点编译: true
片元编译: true
程序链接: true
当前 Program 正确: true
a_position 槽位: 0程序运行后会新增一个带边框的空画布。画布尚未显示三角形是正常的:当前只创建了 Program,没有上传顶点数据,也没有调用 drawArrays。对象保存在 window.webglDemo,刷新页面则需要重新运行。
区分编译失败、链接失败与资源释放
将片元源码中的 outColor 故意改为未声明的 wrongColor 并重新运行:此时编译检查应失败,错误由 getShaderInfoLog 提供;不同浏览器或显卡驱动的报错文字、行号可能不同,不能依赖固定日志字符串。
如果两段 Shader 的 COMPILE_STATUS 都为 true,但 LINK_STATUS 为 false,先核对顶点着色器 out 与片元着色器 in 的名称、类型及数组声明是否匹配,再查看 getProgramInfoLog。不要用 gl.getError() 代替专门的编译、链接状态查询。
本例在成功链接后执行 detachShader,并在 finally 中 deleteShader,保留可继续使用的 Program;创建或链接失败时则用 deleteProgram 回收程序对象。不要在准备继续绘制时删除 Program。如果需要重建着色器程序,应先创建并验证新 Program,再切换绑定并释放旧 Program,避免把失败的重建结果投入绘制。