Swift/Metal管线中顶点/法线数据传入着色器异常问题

你的问题核心是Metal顶点属性的自动对齐规则导致的——Metal要求float3类型的顶点属性必须按16字节对齐，哪怕你手动设置偏移为12，底层也会自动调整到最近的16字节倍数（也就是16），这就和你实际的MTKMesh数据布局产生了偏差。

下面是几个正确的解决方向：

1. 按Metal对齐规则修正vertexDescriptor #

直接把法线属性的偏移设置为16，而不是12：

meshVertexDescriptor.attributes[1].offset = 16 // 替换原来的12

因为Metal会为float3的position自动补充4字节填充，让下一个属性的起始位置满足16字节对齐要求，刚好和MTKMesh的[position(12)+4字节填充+normal(12)+8字节填充]布局匹配。

2. 直接复用MTKMesh自带的VertexDescriptor #

这是最稳妥的方案——MTKMesh在生成时已经根据自身数据布局创建了完全适配的vertexDescriptor，直接用这个就行，不用手动编写：

let mtkMesh = try MTKMesh(mesh: mdlMesh, device: yourDevice)
// 直接使用mtkMesh自带的descriptor
let correctVertexDescriptor = mtkMesh.vertexDescriptor

这样所有属性的偏移、步长、格式都会和MTKMesh的实际数据完全对应，不会出现对齐问题。

3. 自定义MDLMesh的顶点布局（如需手动控制） #

如果必须自定义顶点数据结构，可以在创建MDLMesh时就指定符合Metal对齐要求的MDLVertexDescriptor，确保生成的顶点数据和你后续的Metal descriptor一致：

let mdlVertexDescriptor = MDLVertexDescriptor()
// 配置position：按16字节对齐
mdlVertexDescriptor.attributes[0].name = MDLVertexAttributePosition
mdlVertexDescriptor.attributes[0].format = .float3
mdlVertexDescriptor.attributes[0].offset = 0
mdlVertexDescriptor.attributes[0].bufferIndex = 0
// 配置normal：偏移16，满足16字节对齐
mdlVertexDescriptor.attributes[1].name = MDLVertexAttributeNormal
mdlVertexDescriptor.attributes[1].format = .float3
mdlVertexDescriptor.attributes[1].offset = 16
mdlVertexDescriptor.attributes[1].bufferIndex = 0
// 设置步长32
mdlVertexDescriptor.layouts[0].stride = 32

// 用这个descriptor创建MDLMesh
let mdlMesh = MDLPlane(vertexDescriptor: mdlVertexDescriptor, ...)

这样转成MTKMesh后，数据布局会完全符合你手动设置的Metal descriptor，不会出现偏移错误。

你之前手动把MTKMesh的法线数据偏移4字节能临时解决，本质是让法线数据刚好落到Metal实际读取的16字节位置，但这是绕开问题的临时方案，推荐用上面三种方法从根源解决。

内容的提问来源于stack exchange，提问作者S'rCat