OpenGL纹理加载失败：3D金字塔添加砖墙纹理后窗口变黑

以下是针对纹理加载后窗口变黑问题的常见排查点，结合OpenGL纹理加载的典型错误场景：

• 未检查纹理加载是否成功
  纹理加载失败（比如文件路径实际错误、图片格式不支持）但未做错误判断，会导致后续绑定无效纹理。以stb_image为例，必须强制检查返回值：

  int width, height, nrChannels;
  unsigned char *data = stbi_load("resources/textures/brick.jpg", &width, &height, &nrChannels, 0);
  if (!data) {
      std::cerr << "纹理加载失败" << std::endl;
      return;
  }
  

  即使使用完整路径，也可能存在工作目录不匹配的问题，可以打印当前目录确认：

  char buffer[256];
  getcwd(buffer, sizeof(buffer));
  std::cout << "当前工作目录: " << buffer << std::endl;
  

• OpenGL纹理状态设置缺失
  绑定纹理后必须正确设置环绕、过滤参数并生成纹理，否则部分显卡会因默认参数不兼容导致无法采样：

  unsigned int texture;
  glGenTextures(1, &texture);
  glBindTexture(GL_TEXTURE_2D, texture);
  // 必须设置的纹理参数
  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_REPEAT);
  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_REPEAT);
  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR);
  glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR);
  // 根据图片通道数匹配格式
  GLenum format = nrChannels == 4 ? GL_RGBA : GL_RGB;
  glTexImage2D(GL_TEXTURE_2D, 0, format, width, height, 0, format, GL_UNSIGNED_BYTE, data);
  glGenerateMipmap(GL_TEXTURE_2D);
  stbi_image_free(data); // 别忘了释放加载的图片内存
  

• 着色器未正确处理纹理采样
  要确保顶点着色器传递UV坐标到片段着色器，且片段着色器正确绑定纹理变量：
  顶点着色器示例：

  #version 330 core
  layout (location = 0) in vec3 aPos;
  layout (location = 1) in vec2 aTexCoord;
  
  out vec2 TexCoord;
  
  void main() {
      gl_Position = vec4(aPos, 1.0);
      TexCoord = aTexCoord;
  }
  

  片段着色器示例：

  #version 330 core
  out vec4 FragColor;
  
  in vec2 TexCoord;
  
  uniform sampler2D ourTexture;
  
  void main() {
      FragColor = texture(ourTexture, TexCoord);
  }
  

  渲染时还要激活纹理单元并传递uniform：

  // 初始化时获取uniform位置
  int textureLoc = glGetUniformLocation(shaderProgram, "ourTexture");
  // 渲染循环中
  glActiveTexture(GL_TEXTURE0);
  glBindTexture(GL_TEXTURE_2D, texture);
  glUniform1i(textureLoc, 0); // 告知着色器使用纹理单元0
  

  如果uniform位置返回-1，说明着色器未找到纹理变量，采样结果会是黑色。

• 顶点UV坐标错误
  金字塔的每个顶点必须分配有效的UV坐标（通常在0-1范围内），如果UV坐标全为0或超出范围（且未设置重复/ clamp参数），采样结果会是黑色。检查你的顶点数据：

  float vertices[] = {
      // 位置          // UV坐标
      -0.5f, -0.5f, 0.0f,  0.0f, 0.0f,
       0.5f, -0.5f, 0.0f,  1.0f, 0.0f,
       0.0f,  0.5f, 0.0f,  0.5f, 1.0f
  };
  

• 纹理格式不匹配
  比如PNG图片带Alpha通道，但加载时强制使用RGB格式，或者glTexImage2D的内部格式与源格式不匹配，会导致纹理数据损坏，必须根据nrChannels的值选择正确的format参数。

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