如何在C#中将字节流映射到包含结构体数组的自定义结构体？

我通过私有协议从串口读取字节流，最终得到一个对应另一端发送的对齐结构体的字节数组。该结构体包含一个结构体数组。在C语言中，我可以定义包含固定结构体数组的结构体，直接将字节数组指针强转为结构体指针来访问成员，但C#似乎不允许非基类型的固定数组。目前我只能逐字节读取并复制到结构体成员中，这种方法既繁琐又低效，想知道C#中实现该需求的最优方法。

例如，在C语言中：

byte serialBuff[40];  // 存储包含目标消息的字节数组
typedef struct { char x; char y; } point_t;
typedef struct { char trId; char ack; point_t points[3]; } message_t; 
// message_t在字节缓冲区中的布局：
//                point[0], point[1], point[2]
// 每个元素都是一个字节
// --------------------------------------------
// | trId | ack | x  | y  | x  |  y | x  | y  |
// --------------------------------------------
// ^
// serialBuff起始位置

只需执行以下代码即可正确访问消息：

message_t *myMessage = (message_t *)serialBuff;

是否有办法在C#中实现类似操作，还是必须逐字节读取并复制到结构体或类成员中？

在C#中完全可以实现类似C语言的直接内存映射操作，无需逐字节复制，下面是三种最优实现方式：

1. 安全代码：使用StructLayout和Marshal类 #

这种方式不需要启用不安全代码，适合大多数场景：

首先定义对应C结构体的C#结构体，通过StructLayout指定内存布局，并用MarshalAs标记固定大小的结构体数组：

using System.Runtime.InteropServices;

// 对应C的point_t结构体
[StructLayout(LayoutKind.Sequential, Pack = 1)]
public struct Point
{
    public byte X; // 用byte对应C的char（假设是单字节值）
    public byte Y;
}

// 对应C的message_t结构体
[StructLayout(LayoutKind.Sequential, Pack = 1)]
public struct Message
{
    public byte TrId;
    public byte Ack;
    [MarshalAs(UnmanagedType.ByValArray, SizeConst = 3)]
    public Point[] Points;
}

然后将字节数组转换为结构体：

public static Message BytesToMessage(byte[] buffer)
{
    if (buffer.Length != Marshal.SizeOf(typeof(Message)))
        throw new ArgumentException("缓冲区长度与结构体大小不匹配");

    IntPtr ptr = Marshal.AllocHGlobal(buffer.Length);
    Marshal.Copy(buffer, 0, ptr, buffer.Length);
    Message msg = Marshal.PtrToStructure<Message>(ptr);
    Marshal.FreeHGlobal(ptr);

    return msg;
}

2. 不安全代码：直接指针转换（最接近C语言的方式） #

如果项目允许启用不安全代码，可实现和C几乎一致的强转操作，效率最高：

首先定义结构体时使用fixed关键字声明固定大小的字节缓冲区，再通过访问器转换为结构体指针：

[StructLayout(LayoutKind.Sequential, Pack = 1)]
public unsafe struct Point
{
    public byte X;
    public byte Y;
}

[StructLayout(LayoutKind.Sequential, Pack = 1)]
public unsafe struct Message
{
    public byte TrId;
    public byte Ack;
    public fixed byte PointsBuffer[3 * sizeof(Point)];

    // 便捷访问器，将字节缓冲区转为Point数组指针
    public Point* Points => (Point*)PointsBuffer;
}

然后直接将字节数组指针转换为结构体指针：

public unsafe static Message BytesToMessageUnsafe(byte[] buffer)
{
    if (buffer.Length != sizeof(Message))
        throw new ArgumentException("缓冲区长度与结构体大小不匹配");

    fixed (byte* ptr = buffer)
    {
        return *(Message*)ptr;
    }
}

使用时直接通过指针访问数组元素：

unsafe
{
    Message msg = BytesToMessageUnsafe(serialBuff);
    Point firstPoint = msg.Points[0];
    byte x = firstPoint.X;
}

3. .NET Core/.NET 5+：使用MemoryMarshal.Cast（零拷贝） #

在较新的.NET版本中，可通过MemoryMarshal.Cast实现零拷贝类型转换，兼顾安全与效率：

结构体定义同安全代码中的Point和Message，转换代码如下：

using System.Runtime.InteropServices;

public static Message BytesToMessageSpan(byte[] buffer)
{
    ReadOnlySpan<byte> span = buffer.AsSpan();
    return MemoryMarshal.Cast<byte, Message>(span)[0];
}

关键注意事项 #

• 内存对齐：必须用StructLayout的Pack属性指定与C语言一致的对齐方式（比如C默认对齐为4，若结构体全为单字节类型，Pack=1也可），否则转换会出错。
• 字节序：若结构体包含多字节类型（如int、short），需确保两端字节序一致，必要时用[StructLayout(LayoutKind.Explicit)]和FieldOffset手动指定字段偏移。
• 缓冲区长度：转换前必须验证字节数组长度等于结构体大小（Marshal.SizeOf或sizeof），避免内存越界。

内容的提问来源于stack exchange，提问作者K. Jensen