必须先用gl.getUniformLocation获取uniform位置并检查是否为null，再用gl.uniformMatrix4fv传列主序的16元素数组，且需确保当前绑定正确program。
如何获取uniform location并检查是否有效
在WebGL中，向着色器传递矩阵参数，第一步永远是获取uniform变量的位置。这里有个高频陷阱：如果变量名拼写有误、着色器编译失败，或者变量在代码中被优化掉了，gl.getUniformLocation 的返回值会是 null。直接对这个 null 值调用传值函数，操作会静默失败，画面自然一片漆黑。
- 首先，确保顶点着色器中正确定义了uniform，例如
uniform mat4 u_modelViewProjection;，并且该变量在main函数中被实际引用了。否则，编译器很可能会将其视为无用代码而剔除。 - 获取位置后，立刻进行有效性检查，这是良好的防御性编程习惯：
const loc = gl.getUniformLocation(program, 'u_modelViewProjection'); if (loc === null) { console.error('Uniform not found: u_modelViewProjection'); } - 另外，注意避免在着色器中使用
#define或复杂的条件编译来包裹该uniform声明，这可能导致它在某些情况下“存在但不可见”，同样无法获取到有效位置。
为什么必须用 gl.uniformMatrix4fv 而不是 gl.uniform4fv
这其实是个数据维度问题。一个4x4变换矩阵包含16个浮点数，而 gl.uniform4fv 设计用于传递一个4分量的向量。如果错误混用，数据会发生严重错位，导致渲染结果完全异常，比如模型扭曲或消失。
- 专用函数
gl.uniformMatrix4fv(loc, transpose, matrixArray)就是为此而生。其第二个参数transpose是关键：通常设置为false，表示你传入的数组已经是WebGL默认期望的列主序（column-major）格式。像Three.js库中的matrix.elements就是这种格式。 - 如果你手动构建的数组是数学上更常见的行主序（row-major）排列，就必须将
transpose设为true，让WebGL在内部进行转置。否则，矩阵的变换方向会完全错误。 - 数组长度必须严格为16。如果少于16，数据会被静默截断；多于16，则会触发
INVALID_VALUE错误。
常见矩阵构造错误：Ja vaScript 数组顺序 vs 着色器期望
很多开发者习惯将矩阵想象成二维数组，但在传递给WebGL时，这恰恰是问题的根源。gl.uniformMatrix4fv 只接受一维的 Float32Array 或普通数组，并且要求数据按列主序排列。
- 什么是正确的列主序一维数组？看下面这个排列，它表示的是矩阵的列优先存储：
[m00, m10, m20, m30, // 第一列 m01, m11, m21, m31, // 第二列 m02, m12, m22, m32, // 第三列 m03, m13, m23, m33] // 第四列
- 好消息是，主流数学库如
glMatrix（mat4.create()）和图形库如Three.js（matrix.elements）生成的矩阵默认就是列主序，可以直接使用。 - 如果需要手动填充一个
Float32Array(16)，务必时刻提醒自己“按列填充”。一旦填错顺序，模型可能会缩成一个点、发生镜像翻转或者直接消失，这类问题往往非常隐蔽，排查起来相当耗时。
uniform 传值前必须绑定正确的 program
这一点至关重要，却容易被忽略。WebGL的uniform location是与特定的着色器程序（program）深度绑定的。然而，location值本身只是一个数字标识，并不包含program的上下文信息。
如果你在切换了激活的program之后，却依然使用之前program获取的location来传值，那么数据会被写入到当前激活的（可能是错误的）program中，导致渲染异常或静默失败。
- 安全的做法是，在每次设置uniform前，都确保正确的program已被激活，并将获取location和传值的操作放在同一个上下文中：
gl.useProgram(program); const loc = gl.getUniformLocation(program, 'u_modelViewProjection'); gl.uniformMatrix4fv(loc, false, matrix);
- 避免为了“优化”而全局缓存location并在多个program间复用。不同program中，即使uniform变量名相同，其location值也很可能不同。
- 在调试阶段，可以在
gl.useProgram后加入断言来验证当前激活的程序：console.assert(gl.getParameter(gl.CURRENT_PROGRAM) === program)。
话说回来，传递矩阵参数本身逻辑并不复杂，但实践中真正让人困扰的，往往就是上面提到的这三个环节：location获取失败、数组顺序错误、或者program绑定不对。它们通常不会抛出明确的运行时错误，只会让画面纹丝不动或扭曲变形。一个高效的调试技巧是：在传值前，先打印检查location是否为非空，并输出矩阵数组的前几个值，这比反复调整着色器代码更能快速定位问题根源。
