OpenGL自定义Shader编译问题：顶点着色器可编译片段着色器报错原因

问题背景 #

使用Python编写OpenGL自定义着色器时，顶点着色器可正常编译，但片段着色器触发编译错误。

原顶点着色器代码 #

#version 330 core

layout(location=0) in vec3 vertexPos;

out vec4 position;

void main()
{
position = vec4(vertexPos,1.0);
}

原片段着色器代码 #

#version 330 core

layout(location=1) in vec3 vertexColor;

out vec4 color;

void main()
{
color = vec4(vertexColor,1.0);
}

编译错误信息 #

OpenGL.GL.shaders.ShaderCompilationError: ('Shader compile failure (0): b\'Fragment shader failed to compile with the following errors:\nERROR: 2:1: error(#5) Extension: "explicit attribute location in fragment shader is only supported for the out storage qualifier"\nERROR: error(#273) 1 compilation errors.  No code generated\n\n\'', [b'#version 330 core\n', b'\n', b'layout(location=1) in vec3 vertexColor;\n', b'\n', b'out vec4 color;\n', b'\n', b'void main()\n', b'{\n', b'color = vec4(vertexColor,1.0);\n', b'}\n', b'\n'], GL_FRAGMENT_SHADER)

原因分析 #

1. 片段着色器in变量不能用layout(location)：OpenGL 3.3核心规范中，layout(location)仅允许用于顶点着色器的in变量（绑定顶点属性缓冲区）和片段着色器的out变量（绑定渲染目标）。片段着色器的in变量是来自顶点/几何着色器的varying变量，它们通过变量名匹配或接口块关联，不能直接指定location。
2. 顶点着色器存在规范问题：原顶点着色器未设置gl_Position——这是顶点着色器的强制输出，必须将顶点位置转换为裁剪空间坐标并赋值给gl_Position，否则渲染流程会失效。
3. 变量关联不匹配：原顶点着色器输出的是position，但片段着色器试图接收vertexColor，两者完全不对应，即使修复location问题，后续也会出现变量无数据的错误。

修复方案 #

修正后的顶点着色器 #

#version 330 core

// 顶点位置属性，绑定到location 0
layout(location=0) in vec3 vertexPos;
// 顶点颜色属性，绑定到location 1（如果顶点数据包含颜色）
layout(location=1) in vec3 vertexColor;

// 输出颜色到片段着色器，变量名与片段着色器输入一致
out vec3 fragColor;

void main()
{
    // 必须设置裁剪空间位置
    gl_Position = vec4(vertexPos, 1.0);
    // 传递顶点颜色到片段着色器
    fragColor = vertexColor;
}

修正后的片段着色器 #

#version 330 core

// 接收顶点着色器输出的颜色，去掉location属性
in vec3 fragColor;

// 输出最终颜色到渲染目标
out vec4 color;

void main()
{
    color = vec4(fragColor, 1.0);
}

关键说明 #

• 片段着色器的输入变量必须与上游着色器（顶点/几何）的输出变量名完全匹配，或通过接口块（如out blockName { vec3 color; };和in blockName { vec3 color; };）来关联。
• 顶点着色器必须输出gl_Position，这是OpenGL固定渲染管线的要求，缺失会导致渲染异常。

内容的提问来源于stack exchange，提问作者Root