Metal多绘制调用场景下深度测试不生效问题咨询

云上老周

2026-10-6

1. 渲染通道深度附件动作配置错误

你当前的深度附件配置为：

renderPassDescriptor.depthAttachment.loadAction = MTLLoadActionLoad;
renderPassDescriptor.depthAttachment.storeAction = MTLStoreActionDontCare;

如果你的多个绘制调用是在**不同的渲染通道（即每次绘制都创建了新的MTLRenderCommandEncoder）**中执行的，这个配置就会直接导致深度失效：
MTLStoreActionDontCare意味着当前渲染通道结束后，GPU可以直接丢弃深度缓冲区的内容，不会写入到纹理中，下一个渲染通道用MTLLoadActionLoad读取到的就是无效的垃圾值，自然无法正确做深度测试。

修复方法：

每一帧的第一个渲染通道，将loadAction设为MTLLoadActionClear，清空上一帧的残留深度
所有需要保留深度内容供后续渲染通道使用的配置，将storeAction设为MTLStoreActionStore
如果你的多个绘制调用都在同一个渲染通道内执行，那这个配置是正常的，不需要修改，继续排查下一个问题。

2. 裁剪空间Z值范围不兼容Metal要求

这是从OpenGL迁移到Metal最常见的深度问题：

OpenGL的归一化设备坐标（NDC）Z轴范围是[-1, 1]，你当前使用的matrix_perspective_right_hand是OpenGL兼容的实现，输出的裁剪空间Z值也符合这个范围
Metal的默认NDC Z轴范围是[0, 1]，直接使用OpenGL兼容的投影矩阵输出的Z值会导致所有小于0的深度被错误裁剪，深度比较逻辑完全异常。

修复方法（二选一即可）：

在顶点着色器中手动调整Z值：

float4 position = float4(in.data.xyz, 1.0);
out.position = uniforms.projectionMatrix * uniforms.modelViewMatrix * position;
// 手动将Z从[-1,1]映射到Metal要求的[0,1]
out.position.z = (out.position.z + out.position.w) * 0.5;