本文详解 lwjgl 3 中投影矩阵未生效的典型原因——宽高比（aspect ratio）计算错误及未正确传入，导致 3d 空间变形失真，即使 fov 变化可见，矩形仍无法校正为正方形。
本文详解 lwjgl 3 中投影矩阵未生效的典型原因——宽高比（aspect ratio）计算错误及未正确传入，导致 3d 空间变形失真，即使 fov 变化可见，矩形仍无法校正为正方形。
在使用 LWJGL 3 进行 OpenGL 渲染时，若发现应用了透视投影矩阵后，本应呈现为正方形的 Quad 依然显示为拉伸的矩形（如宽高比明显失衡），而仅 FOV 变化影响整体缩放——这几乎可以确定是 投影矩阵中宽高比（aspect ratio）设置错误 所致。
核心问题出在 init() 方法中的这段代码：
float aspectRatio = 640 / 480; // ❌ 错误：整数除法，结果恒为 1
projectionMatrix.perspective(
(float) Math.toRadians(FOV),
1, // ❌ 错误：硬编码为 1，未使用 aspectRatio
Z_NEAR, Z_FAR
);
? 问题剖析
整数除法陷阱
640 / 480是两个int字面量的运算，Java 会执行整数除法，结果为1（而非1.333...）。即使赋值给float aspectRatio，也已丢失精度。参数未实际使用
perspective()方法的第二个参数是aspect，但代码中直接传入了常量1，完全忽略了已声明的aspectRatio变量，导致投影矩阵始终按 1:1 宽高比构建——即“正方形视口”，而实际窗口（如 640×480）却是 4:3 矩形，从而引发横向拉伸。
✅ 正确实现方式
请将 init() 中的投影矩阵初始化修正为：
// ✅ 正确：显式浮点运算，确保精度；并传入计算出的宽高比
int width = 640; // 建议从 Window 实例动态获取，见下方说明
int height = 480;
float aspectRatio = (float) width / height;
projectionMatrix = new Matrix4f();
projectionMatrix.perspective(
(float) Math.toRadians(FOV),
aspectRatio, // ✅ 关键：使用计算出的 aspectRatio
Z_NEAR,
Z_FAR
);
? 最佳实践建议：不要硬编码窗口尺寸。应通过
Window对象实时获取当前宽高（例如window.getWidth()/window.getHeight()），以支持窗口缩放或不同分辨率：float aspectRatio = (float) window.getWidth() / window.getHeight();
? 验证效果
- 修改后重新运行，原本被横向拉伸的 Quad 将恢复为视觉上等宽等高的正方形；
- 调整 FOV 仍会影响远近缩放（符合预期），但形状比例不再失真；
- 若窗口大小动态变化，务必在
resize回调中重新计算并更新 projectionMatrix，并重新上传至着色器。
⚠️ 补充注意事项
- 确保顶点着色器中正确声明并使用
projectionMatrix：#version 330 core layout (location = 0) in vec3 aPos; uniform mat4 projectionMatrix; void main() { gl_Position = projectionMatrix * vec4(aPos, 1.0); } -
Matrix4f.perspective()默认生成的是 OpenGL 标准右手坐标系投影矩阵（Z 轴朝外，NDC Z ∈ [−1,1]），无需额外翻转； - 使用
BufferUtils.createFloatBuffer(16)传递矩阵时，确保mat.get(buffer)写入顺序与 GLSL 的列主序（column-major）兼容——LWJGL 的Matrix4f.get()默认满足此要求，无需手动转置。
遵循以上修正，投影矩阵即可真正发挥空间校正作用，使 3D 几何体在不同分辨率下保持正确的比例关系。
