OpenGL三角形无法显示，请求排查错误及提供调试方法

针对你的代码的常见错误排查 #

• VAO/VBO与顶点属性绑定错误：确认已正确生成并绑定VAO、VBO，glVertexAttribPointer的步长、偏移量等参数和顶点数据格式完全匹配，且调用了glEnableVertexAttribArray启用对应顶点属性。
• 着色器编译/链接失败：必须添加编译、链接后的错误检查，很多黑屏都是因为着色器语法错误却没被发现。示例代码：

  GLint success;
  char infoLog[512];
  // 检查顶点着色器编译
  glGetShaderiv(vertexShader, GL_COMPILE_STATUS, &success);
  if(!success) {
      glGetShaderInfoLog(vertexShader, 512, NULL, infoLog);
      std::cout << "顶点着色器编译失败:\n" << infoLog << std::endl;
  }
  // 检查程序链接
  glGetProgramiv(shaderProgram, GL_LINK_STATUS, &success);
  if(!success) {
      glGetProgramInfoLog(shaderProgram, 512, NULL, infoLog);
      std::cout << "着色器程序链接失败:\n" << infoLog << std::endl;
  }
  

• 绘制调用参数错误：检查glDrawArrays的顶点数量是否和你传入的顶点数据一致，绘制模式是否设为GL_TRIANGLES。
• 视口未正确设置：确认调用了glViewport(0, 0, 窗口宽度, 窗口高度)，否则三角形可能被渲染到视口外。
• 缓冲清除不完整：确保每次渲染前调用glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT)，如果开启了深度测试却没清除深度缓冲，会导致后续绘制被遮挡。

未来调试OpenGL问题的通用方法 #

• 开启调试输出：创建GLFW窗口时开启调试上下文，并注册回调捕获错误：

  // 创建窗口前设置
  glfwWindowHint(GLFW_OPENGL_DEBUG_CONTEXT, GL_TRUE);
  // 初始化后注册回调
  void APIENTRY glDebugOutput(GLenum source, GLenum type, GLuint id, GLenum severity, GLsizei length, const GLchar* message, const void* userParam) {
      if(severity != GL_DEBUG_SEVERITY_NOTIFICATION) {
          std::cout << "OpenGL调试信息:\n" << message << std::endl;
      }
  }
  glEnable(GL_DEBUG_OUTPUT);
  glEnable(GL_DEBUG_OUTPUT_SYNCHRONOUS);
  glDebugMessageCallback(glDebugOutput, nullptr);
  

• 分步验证渲染流程：
  • 先渲染纯色全屏四边形，确认着色器、视口、窗口渲染链路正常。
  • 简化顶点数据，用最基础的三角形坐标（如{-0.5f, -0.5f}, {0.5f, -0.5f}, {0.0f, 0.5f}）排除数据格式问题。
• 使用专业调试工具：
  • 用RenderDoc或apitrace捕获渲染帧，直观查看VAO/VBO数据、着色器状态、绘制调用的详细信息，快速定位问题。
  • 在关键步骤后调用glGetError()，快速排查明显的API调用错误。

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