正确绑定VBO需先glGenBuffers生成合法ID再glBindBuffer,否则glBufferData无效;着色器须检查编译/链接状态并获取日志;启用attribute需glVertexAttribPointer配合glEnableVertexAttribArray;黑屏常因深度测试未开、数据类型不匹配或gl_Position未赋值。
直接绑定 VBO 前必须先生成并绑定 VBO,否则 glBufferData 会静默失败或触发 GL_INVALID_OPERATION。常见错误是跳过 glGenBuffers 或误将 0 当作有效 ID 传给 glBindBuffer。
GLuint vboID; 必须通过 glGenBuffers(1, &vboID) 获取合法 ID,不能手动赋值glBufferData(GL_ARRAY_BUFFER, size, data, GL_STATIC_DRAW);未绑定时调用该函数无效glBindBuffer(GL_ARRAY_BUFFER, vboID)),切勿依赖“上一次绑定残留”glVertexAttribPointer 的步长和偏移要与实际内存布局严格一致OpenGL 着色器编译失败默认不抛异常,glCompileShader 和 glLinkProgram 都返回成功,但实际不可用。必须主动检查日志。
glGetShaderiv(shader, GL_COMPILE_STATUS, &result) 判断是否成功,失败则用 glGetShaderInfoLog 获取错误文本glGetProgramiv(program, GL_LINK_STATUS, &result) 检查,并用 glGetProgramInfoLog 提取详细错误#version 版本号与上下文创建的 OpenGL 版本不匹配(如用 #version 450 但只创建了 OpenGL 3.3 上下文)\r\n 不影响,但空指针或截断字符串会导致编译器静默失败核心在于 glVertexAttribPointer 的参数顺序和启用开关,漏掉任一环节都会导致黑屏或乱点。
glUseProgram(program) 激活着色器程序glGetAtt
ribLocation(program, "aPos") 获取属性位置(假设顶点着色器中声明为 in vec3 aPos;),返回值为 -1 表示未找到(变量名拼错 / 未使用 / 优化掉了)glVertexAttribPointer(loc, 3, GL_FLOAT, GL_FALSE, stride, (void*)offset) —— 注意 stride 是整个顶点结构字节数,offset 是该属性起始偏移(如法线在位置之后,则 offset = sizeof(float) * 3)glEnableVertexAttribArray(loc),否则该 attribute 被忽略多数不是代码逻辑错误,而是状态管理疏忽或数据格式不匹配。
glEnable(GL_DEPTH_TEST) 或未清深度缓冲(glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)),导致前后遮挡失效glVertexAttribPointer 中指定的 type 不一致(如数据是 double 却传 GL_FLOAT)EBO)未正确绑定或 glDrawElements 参数错误:比如用 GL_UNSIGNED_INT 但索引数组是 unsigned short
gl_Position 未被赋值,或写成 position(无此内置变量),编译可能通过但运行时无输出
// 示例:最简 VBO + 着色器绘制单个三角形
float vertices[] = {
-0.5f, -0.5f, 0.0f,
0.5f, -0.5f, 0.0f,
0.0f, 0.5f, 0.0f
};
GLuint VBO, VAO;
glGenVertexArrays(1, &VAO);
glGenBuffers(1, &VBO);
glBindVertexArray(VAO);
glBindBuffer(GL_ARRAY_BUFFER, VBO);
glBufferData(GL_ARRAY_BUFFER, sizeof(vertices), vertices, GL_STATIC_DRAW);
glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 3 sizeof(float), (void)0);
glEnableVertexAttribArray(0);
// 绘制时:
glUseProgram(shaderProgram);
glBindVertexArray(VAO);
glDrawArrays(GL_TRIANGLES, 0, 3);
VBO 和着色器本身不难,真正卡住人的永远是状态切换时机、错误检查缺失、以及数据布局和着色器变量之间那几字节的对不上。