glCompileShader失败但无错误信息是因为未调用glGetShaderInfoLog；必须先用glGetShaderiv检查GL_COMPILE_STATUS为GL_FALSE，再显式调用glGetShaderInfoLog获取日志，常见原因包括缺失#version声明、语法错误或OpenGL上下文版本不匹配。
编译GLSL着色器时遇到glCompileShader失败但没报错信息？
GLSL着色器编译失败时，glGetShaderiv(shader, GL_COMPILE_STATUS, &status) 返回 GL_FALSE，但错误日志默认为空——必须显式调用 glGetShaderInfoLog 才能拿到具体错误。常见原因包括：GLSL版本声明缺失（如忘了写 #version 330 core）、语法拼写错误、或OpenGL上下文版本与着色器要求不匹配（比如用#version 450却只创建了OpenGL 3.3上下文）。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 每次调用
glCompileShader后立即检查编译状态，并用glGetShaderInfoLog读取至少 512 字节日志缓冲区 - 确保着色器源码字符串末尾有
\0（用std::string::c_str()安全；若手动构造const char**数组，别漏掉终止空指针） - 在
glCreateShader前确认当前 OpenGL 上下文已激活且有效（多线程环境尤其容易出问题）
链接着色器程序后glGetUniformLocation 返回-1？
返回 -1 表示 Uniform 变量未被使用或未被正确发现。不是“找不到变量名”，而是该 Uniform 在最终优化后的着色器中被编译器剔除了——哪怕你写了 uniform mat4 model;，只要它在 main 中完全没参与计算，驱动就会丢弃它。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 在着色器里对 Uniform 做“假使用”：比如
gl_Position = projection * (view * (model * vec4(0.0)));中哪怕只用一次model，也能阻止优化移除 - 确认 Uniform 名字拼写完全一致（区分大小写），且没有多余空格；结构体成员需用点号访问（如
light.position），不能直接用light_position - 链接成功后才调用
glGetUniformLocation；链接失败时该函数行为未定义
传递glm::mat4到uniform mat4时画面错乱或黑屏？
最常见原因是矩阵内存布局不匹配：glm::mat4 默认是列主序（column-major），而 OpenGL 的 glUniformMatrix4fv 默认也期望列主序——但参数 transpose 若误设为 GL_TRUE，就会把本就正确的矩阵再转置一次，导致变换完全错误。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 始终传
GL_FALSE给glUniformMatrix4fv(location, 1, GL_FALSE, &m[0][0])（&m[0][0]是取首元素地址，glm 矩阵内存连续） - 检查是否忘记调用
glUseProgram(programID)—— Uniform 设置只对当前激活的 program 生效 - 标量 Uniform（如
float、vec3）用glUniform1f/glUniform3fv，别混用；数组需逐个设置或用带fv/iv后缀的批量接口
运行时修改Uniform值但画面无变化？
可能 Uniform 值确实传进去了，但 shader 没重绘——OpenGL 是状态机，设置 Uniform 不会自动触发绘制。更隐蔽的问题是：你用了 glUniform*() 但没绑定对应 program，或者绑了 program 却在别的 VAO/VBO 状态下绘制。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 确保绘制前执行顺序为：
glUseProgram(program)→glUniform*()→glBindVertexArray(VAO)→glDraw* - 调试时可在每次
glUniform*后加glGetError()，快速定位非法调用（如 program 未链接成功时调用glUniform会返回GL_INVALID_OPERATION） - 避免在循环内反复调用
glGetUniformLocation——它开销不小；应在初始化阶段缓存 location 整数
Uniform 传递本身不复杂，但每个环节都依赖前序步骤的正确性：上下文、编译、链接、use、绑定、绘制，缺一不可。最容易被忽略的是“链接失败后仍继续使用 program ID”，以及“矩阵 transpose 参数写反”。这两处出问题，往往连错误提示都没有，只能靠日志和状态检查硬挖。
