lwjgl 3 使用 opengl core profile 时必须显式编写并绑定顶点/片元着色器，否则即使 vao/vbo 正确创建，gpu 也无法执行任何渲染指令——这是导致“窗口可见但画面全黑”的最常见原因。
在你的代码中，ModelLoader 和 Renderer 虽然正确完成了 VAO/VBO 的创建、绑定与数据上传，也调用了 glDrawArrays，但整个渲染管线缺失最关键的一环：着色器程序（Shader Program）。OpenGL Core Profile（你通过 GLFW_OPENGL_CORE_PROFILE 启用）已完全移除了固定功能管线（Fixed-Function Pipeline），不再支持 glBegin/glEnd 或默认的顶点变换与颜色输出逻辑。所有顶点处理和像素生成都必须由用户提供的 GLSL 着色器控制。
✅ 必须补充的核心组件
你需要添加以下三部分：
1. 着色器源码（建议存为 vertex.glsl 和 fragment.glsl）
vertex.glsl
#version 150 core
in vec3 position;
void main() {
gl_Position = vec4(position, 1.0);
}fragment.glsl
#version 150 core
out vec4 outColor;
void main() {
outColor = vec4(1.0, 0.0, 0.0, 1.0); // 红色三角形
}⚠️ 注意：#version 150 core 必须与你请求的 OpenGL 上下文版本（3.2）兼容；LWJGL 3.2+ 默认支持 GLSL 150（对应 OpenGL 3.2）。
2. 着色器加载与编译工具类（例如 ShaderProgram.java）
package core;
import org.lwjgl.system.MemoryUtil;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import static org.lwjgl.opengl.GL20.*;
public class ShaderProgram {
private final int programID;
public ShaderProgram(String vertexPath, String fragmentPath) {
int vertexShader = compileShader(GL_VERTEX_SHADER, readFile(vertexPath));
int fragmentShader = compileShader(GL_FRAGMENT_SHADER, readFile(fragmentPath));
programID = glCreateProgram();
glAttachShader(programID, vertexShader);
glAttachShader(programID, fragmentShader);
glLinkProgram(programID);
if (glGetProgrami(programID, GL_LINK_STATUS) == GL_FALSE) {
throw new RuntimeException("Shader linking failed: " + glGetProgramInfoLog(programID));
}
glDeleteShader(vertexShader);
glDeleteShader(fragmentShader);
}
private int compileShader(int type, String source) {
int shader = glCreateShader(type);
glShaderSource(shader, source);
glCompileShader(shader);
if (glGetShaderi(shader, GL_COMPILE_STATUS) == GL_FALSE) {
throw new RuntimeException("Shader compilation failed: " + glGetShaderInfoLog(shader));
}
return shader;
}
private String readFile(String path) {
try {
return Files.readString(Paths.get(path));
} catch (IOException e) {
throw new RuntimeException("Failed to read shader file: " + path, e);
}
}
public void bind() {
glUseProgram(programID);
}
public void unbind() {
glUseProgram(0);
}
public void cleanup() {
glDeleteProgram(programID);
}
}3. 在渲染循环中绑定着色器
修改 LWJGLTutorial.run() 中的渲染部分：
// 在初始化阶段（glfwMakeContextCurrent 之后、渲染循环之前）创建着色器
ShaderProgram shader = new ShaderProgram("src/main/resources/vertex.glsl", "src/main/resources/fragment.glsl");
// 在渲染循环中：
while (!glfwWindowShouldClose(window)) {
glClearColor(0.1f, 0.1f, 0.1f, 1.0f);
glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
shader.bind(); // ← 关键：启用着色器程序
Renderer.render(model);
shader.unbind(); // ← 可选，但推荐显式解绑
glfwSwapBuffers(window);
glfwPollEvents();
}
// 渲染结束后清理
shader.cleanup();同时，更新 Renderer.render() 以确保状态安全（可选增强）：
public static void render(RawModel model) {
glBindVertexArray(model.getVAO());
glDrawArrays(GL_TRIANGLES, 0, model.getVertexCount());
glBindVertexArray(0); // 好习惯：解绑 VAO
}? 其他潜在风险点（检查清单）
- ✅ OpenGL 上下文是否已正确创建？ → 你已调用 GL.createCapabilities()，没问题。
- ✅ VAO 是否在正确的上下文中创建？ → 是，在 glfwMakeContextCurrent(window) 之后，正确。
- ✅ 顶点属性指针索引是否匹配着色器 in 变量？ → 你使用 glVertexAttribPointer(0, ...)，着色器中 in vec3 position 绑定到 location 0，匹配。
- ❌ 是否启用了 GL_DEPTH_TEST 却未写入深度值？ → 当前着色器无深度操作，建议暂时注释 glEnable(GL_DEPTH_TEST)，避免因深度测试失败导致片段被丢弃（尤其当清除深度缓冲未初始化或 Z 值冲突时）。
✅ 总结
| 问题现象 | 根本原因 | 解决方案 |
|---|---|---|
| 窗口正常但无任何图形 | 缺少着色器程序（Shader Program） | 编写 GLSL 着色器 + 编译链接 + 渲染时 glUseProgram() |
没有着色器，OpenGL 就像一台没有安装操作系统的电脑——硬件就绪，却不知如何执行任务。补上着色器后，你的红色矩形将立即呈现。务必确保 .glsl 文件路径正确，并在构建时将其复制到 classpath（如 src/main/resources/）。
