Unity中ComputeShader数值异常：为何输出值全部错误？

问题现象 #

将C#侧定义的CSOrbitFunction结构体数据传入Compute Shader后，直接给outX/outY/outZ赋值固定值（如666.666）可正常生效，但读取periapsis/apoapsis字段赋值给输出时，结果完全错误；但periapsis和apoapsis本身在C#侧的初始值是正确的。

核心原因 #

C#与HLSL的结构体内存布局规则不匹配，导致Shader读取double类型字段时出现内存错位：

• C#侧使用[StructLayout(LayoutKind.Explicit)]强制指定每个字段的字节偏移，periapsis从28字节开始，apoapsis从36字节开始。
• HLSL侧结构体默认采用自然对齐规则：double类型需要8字节对齐，即字段起始偏移必须是8的倍数。原Shader结构体中，outZ结束后总字节数为28，28不是8的倍数，HLSL会自动填充4字节空白，导致periapsis实际起始偏移变为32字节，与C#侧的28字节偏移完全错位。此时Shader读取的periapsis实际是C#结构体中其他字段的内存数据，转换后自然错误。

代码对比与验证 #

C#侧结构体（显式偏移） #

[StructLayout(LayoutKind.Explicit)]
public struct CSOrbitFunction
{
    [FieldOffset(0)]
    public OrbitTypes type; // 4字节

    [FieldOffset(4)] public float offsetX;
    [FieldOffset(8)] public float offsetY;
    [FieldOffset(12)] public float offsetZ; // 累计28字节前结束

    [FieldOffset(16)] public float outX;
    [FieldOffset(20)] public float outY;
    [FieldOffset(24)] public float outZ; // 24-28字节

    [FieldOffset(28)] public double periapsis; // 28-36字节（double占8字节）
    [FieldOffset(36)] public double apoapsis; // 36-44字节
    [FieldOffset(44)] public int durationSeconds;

    [FieldOffset(48)] public int previous;
    [FieldOffset(52)] public int id;

    public static int SizeInBytes = 56;
}

原HLSL结构体（默认布局导致错位） #

struct CSOrbitFunction
{
    int type;
    
    float offsetX;
    float offsetY;
    float offsetZ;
    
    float outX;
    float outY;
    float outZ;    
    
    // 此处因8字节对齐，实际起始偏移为32（而非28），与C#侧错位
    double periapsis;
    double apoapsis;
    int durationSeconds;
    
    int previous;
    int id;
};

解决方法 #

在HLSL结构体中使用packoffset显式指定每个字段的字节偏移（与C#侧完全对应），强制对齐内存布局：

struct CSOrbitFunction
{
    int type : packoffset(c0);          // 0字节（c0 = 0*4）
    float offsetX : packoffset(c1);     // 4字节（c1 = 1*4）
    float offsetY : packoffset(c2);     // 8字节
    float offsetZ : packoffset(c3);     // 12字节
    
    float outX : packoffset(c4);        // 16字节
    float outY : packoffset(c5);        // 20字节
    float outZ : packoffset(c6);        // 24字节
    
    double periapsis : packoffset(c7);  // 28字节（c7=7*4，double占c7、c8两个槽位）
    double apoapsis : packoffset(c9);   // 36字节（c9=9*4，占c9、c10两个槽位）
    int durationSeconds : packoffset(c11); // 44字节
    
    int previous : packoffset(c12);     // 48字节
    int id : packoffset(c13);           // 52字节
};

注：packoffset(cN)中的N代表4字节槽位的索引，即实际字节偏移为N*4；double类型占2个连续槽位。

修改后，Shader与C#侧的结构体内存布局完全一致，读取periapsis/apoapsis字段时即可获取正确数据，赋值给输出字段也会正常生效。

内容的提问来源于stack exchange，提问作者jeancallisti