stb_image是首选图像加载器，因其单头文件、零依赖、支持PNG/JPEG等多格式，并自动处理通道数与Y轴翻转；需调用stbi_set_flip_vertically_on_load(true)适配OpenGL纹理坐标，避免上下颠倒。
直接用 stb_image + glTexImage2D 是当前最稳、最轻量、兼容性最好的做法，别碰系统自带 BMP 加载或手写 BMP 解析——容易翻车，且不支持 PNG/JPEG。
为什么 stb_image 是首选加载器
它是个单头文件库，不用编译、不依赖 DLL，支持 PNG/JPEG/TGA/BMP/PSD/GIF（部分），自动处理通道数、翻转 Y 轴、内存对齐。关键点是：它返回的像素数据默认是 **从上到下** 的，而 OpenGL 纹理坐标 (0,0) 在左下角，所以多数情况要调 stbi_set_flip_vertically_on_load(true)，否则贴图上下颠倒。
常见错误现象：
-
stbi_load返回nullptr，但路径没错 → 忘了调stbi_set_flip_vertically_on_load或没加#define STB_IMAGE_IMPLEMENTATION前置定义 - 贴图颜色发紫/偏色 → 图像含 Alpha 通道（4 通道），但你传了
GL_RGB给glTexImage2D的format参数 - 纹理显示为黑块 → 忘了
glBindTexture(GL_TEXTURE_2D, textureID)就调glTexImage2D，或者没启用 2D 纹理（glEnable(GL_TEXTURE_2D)已被现代 OpenGL 废弃，仅在兼容模式下需要）
glTexImage2D 参数配错的典型组合
这个函数九个参数里，最容易出错的是第 3、7、8 项：内部格式、像素格式、像素类型。它们必须逻辑一致：
立即学习“C++免费学习笔记（深入）”；
- 如果你用
stbi_load(..., 0, STBI_rgb)加载 → 数据是 3 通道，应设internalformat = GL_RGB，format = GL_RGB，type = GL_UNSIGNED_BYTE - 如果用
stbi_load(..., 0, STBI_rgb_alpha)→ 数据是 4 通道，对应internalformat = GL_RGBA，format = GL_RGBA - BMP 文件实际存的是 BGR 顺序（不是 RGB）→ 此时得用
format = GL_BGR，否则红蓝通道互换 - 图像宽高不是 2 的幂次（如 1920×1080）→ OpenGL 旧版本会拒绝，现代核心上下文虽允许，但 mipmap 生成（
glGenerateMipmap）可能失败，建议用stb_image_resize或提前缩放
纹理参数设置不当导致的“缝隙”和“模糊”
不设纹理参数，OpenGL 会用默认值，结果常是边缘拉伸、缩放糊成一片、或 UV 接缝处出现细线。重点配这四个：
-
GL_TEXTURE_WRAP_S/GL_TEXTURE_WRAP_T：控制 UV 超出 [0,1] 时的行为。平铺用GL_REPEAT，边缘截断用GL_CLAMP_TO_EDGE（推荐，避免采样边界外脏数据） -
GL_TEXTURE_MIN_FILTER：纹理缩小（mipmap）时的过滤方式。要抗锯齿必须开 mipmap：GL_LINEAR_MIPMAP_LINEAR；否则用GL_LINEAR避免块状失真 -
GL_TEXTURE_MAG_FILTER：纹理放大时的过滤方式。基本都用GL_LINEAR，除非你要像素风效果才选GL_NEAREST
漏掉 glGenerateMipmap 却设了 mipmap 过滤，会导致纹理全黑——这是新手最高频的“黑屏”原因。
绑定与激活时机容易被忽略的细节
纹理 ID 本身只是个编号，真正起作用靠的是「当前绑定」+「着色器中采样器 uniform 的绑定位置」。两个关键动作不能少：
- 加载完纹理后，必须调一次
glBindTexture(GL_TEXTURE_2D, textureID)才能对它设置参数或传像素数据 - 渲染前，必须再次
glBindTexture(GL_TEXTURE_2D, textureID)，否则你用的可能是上一个纹理 - 如果用了多个纹理（比如 diffuse + normal），需用
glActiveTexture(GL_TEXTURE0 + i)切换单元，并确保着色器里uniform sampler2D u_diffuse绑定到了同一单元（glUniform1i(loc, i)）
最隐蔽的问题：同一个纹理 ID 在多处 glBind，但没检查是否真的生效——建议每次 glBind 后加一句 glGetError() 快速定位绑定失败。
