天空盒渲染为纯黑或闪烁马赛克，主因是立方体贴图加载错误：未用glTexImage2D分6次按GL_TEXTURE_CUBE_MAP_POSITIVE_X至NEGATIVE_Z顺序上传各面，或未设GL_CLAMP_TO_EDGE包裹模式、采样向量未归一化。
为什么天空盒渲染出来是纯黑或闪烁马赛克
绝大多数情况是立方体贴图的纹理坐标没对齐，或者 glTexImage2D 被误用于加载单张面——立方体贴图必须用 glTexImage2D 分别传入 6 个面（GL_TEXTURE_CUBE_MAP_POSITIVE_X 到 GL_TEXTURE_CUBE_MAP_NEGATIVE_Z），不能用 glTexImage3D 或一次性上传。常见错误还包括：忘记调用 glTexParameteri 设置 GL_TEXTURE_WRAP_S/T/R 为 GL_CLAMP_TO_EDGE（否则采样边界会插值到相邻面，导致黑边或错乱）；或者顶点着色器里把世界空间位置直接当采样向量用了，但没归一化（normalize() 缺失 → 向量长度不为 1 → UV 偏移）。
如何正确加载 6 张 PNG/JPG 组成的立方体贴图
OpenCV 或 stb_image 都能读图，关键是顺序和坐标系要匹配 OpenGL 的约定：X+（右）、X−（左）、Y+（上）、Y−（下）、Z+（后）、Z−（前）。stb_image 默认是 BGR 且 y 轴翻转，需手动 flip Y 并转换为 RGB：
// 示例：用 stb_image 加载一个面
int w, h, comp;
unsigned char* data = stbi_load(path.c_str(), &w, &h, &comp, 4); // 强制 4 通道
if (!data) { /* 报错 */ }
// 注意：stb_image 是从上到下存储，OpenGL 纹理原点在左下，所以需要垂直翻转
for (int i = 0; i < h / 2; ++i) {
unsigned char* row1 = data + i * w * 4;
unsigned char* row2 = data + (h - 1 - i) * w * 4;
std::swap_ranges(row1, row1 + w * 4, row2);
}
glTexImage2D(face_target, 0, GL_RGBA, w, h, 0, GL_RGBA, GL_UNSIGNED_BYTE, data);
stbi_image_free(data);
关键点：
-
face_target必须是GL_TEXTURE_CUBE_MAP_POSITIVE_X等六个枚举之一，按顺序对应文件名（如right.jpg,left.jpg,top.jpg,bottom.jpg,back.jpg,front.jpg） - 所有 6 个面必须尺寸完全相同（宽高相等，推荐 1024×1024）
- 加载完立即设置：
glTexParameteri(GL_TEXTURE_CUBE_MAP, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE)（同理设 T/R） - 不要调用
glGenerateMipmap—— 天空盒通常禁用 mipmap，避免远处模糊或过渡异常
顶点/片元着色器里怎么采样立方体贴图
天空盒本质是“以摄像机为中心、无限远的大立方体”，所以只需用摄像机空间（view space）的视线方向做采样向量。关键不是顶点位置，而是从摄像机出发的方向向量：
立即学习“C++免费学习笔记（深入）”；
// 顶点着色器（skybox.vsh）
in vec3 aPos;
uniform mat4 uView;
uniform mat4 uProjection;
out vec3 TexCoords;
<p>void main() {
// 注意：丢弃平移分量（只保留旋转），让天空盒随视角转动但不随位置移动
vec3 pos = vec3(uView <em> vec4(aPos, 1.0));
TexCoords = pos; // view-space direction → 直接作为采样坐标
gl_Position = uProjection </em> vec4(pos, 1.0);
}</p>
// 片元着色器（skybox.fsh）
in vec3 TexCoords;
uniform samplerCube uSkybox;
out vec4 FragColor;
<p>void main() {
FragColor = texture(uSkybox, TexCoords);
}</p>注意点：
- 顶点着色器中不能用
uModel * uView * ...—— 天空盒没有模型变换，只受 view 矩阵影响，且要剔除平移（即只取 view 矩阵的 3×3 旋转部分） - 务必关闭深度写入：
glDepthMask(GL_FALSE)，否则天空盒会遮挡后续物体；渲染完天空盒再恢复：glDepthMask(GL_TRUE) - 如果场景有 gamma 校正，天空盒贴图也要走同样流程（sRGB 格式加载 +
GL_SRGB8_ALPHA8内部格式）
为什么天空盒总被主场景物体挡住
因为默认深度测试会比较天空盒的 z 值（接近 1.0）和物体的 z 值，而天空盒应永远在最远端。解决方案不是改 z 值，而是绕过深度测试写入：
- 渲染天空盒前：
glDisable(GL_DEPTH_TEST)（更稳妥）或glDepthFunc(GL_LEQUAL)+ 手动把gl_Position.z设为1.0（但需保证顶点在裁剪空间内） - 更推荐做法：保持
GL_DEPTH_TEST开启，但在绘制天空盒时把深度缓冲设为只读：glDepthMask(GL_FALSE)，同时确保天空盒顶点的gl_Position.w和z构成的 NDC z 值 ≈ 1.0（即远平面） - 另一个隐藏坑：天空盒 mesh 的顶点顺序通常是顺时针，但若启用了背面剔除（
glEnable(GL_CULL_FACE)），需确认是否glCullFace(GL_BACK)—— 天空盒内部观察，应剔除正面（即GL_FRONT）
最简健壮流程：清屏 → 关深度写入 → 绘天空盒 → 开深度写入 → 绘场景。立方体贴图本身不难，难在坐标系、采样方向、深度行为这三处细节一旦错一个，就全黑或错位。
