Go语言如何序列化包含固定长度结构体切片的复合结构体

报错原因 #

标准库encoding/binary的Write方法仅支持固定内存大小的类型序列化，你定义的test结构体包含动态长度的[]config切片，无法预先计算整体内存大小，因此直接传入整个结构体时会抛出invalid type错误。

替代方案（无需逐元素手动编码） #

因为config本身是固定大小的结构体，元素为固定大小类型的切片原生支持被binary.Write直接序列化，仅需要拆分结构体的序列化步骤即可：

实现代码 #

package main

import (
    "bytes"
    "encoding/binary"
)

type (
    config struct {
        Key uint16
        Val uint16
    }
    test struct {
        Mode uint32
        Data []config
    }
)

func assert(err error) {
    if err != nil {
        panic(err)
    }
}

func main() {
    t := test{
        Mode: 5,
        Data: []config{
            {1, 2},
            {3, 4},
        },
    }
    var bs bytes.Buffer
    // 1. 序列化固定长度的Mode字段
    assert(binary.Write(&bs, binary.LittleEndian, t.Mode))
    // 2. 序列化切片长度（类型和C端约定即可，示例用uint32保证32/64位兼容）
    assert(binary.Write(&bs, binary.LittleEndian, uint32(len(t.Data))))
    // 3. 直接序列化整个切片，无需逐元素编码
    assert(binary.Write(&bs, binary.LittleEndian, t.Data))
}

兼容性说明 #

上述代码输出的二进制结构完全兼容C端定义，C侧可直接用带柔性数组的结构体解析：

#include <stdint.h>
struct config {
    uint16_t Key;
    uint16_t Val;
};
struct test {
    uint32_t Mode;
    uint32_t data_len;
    struct config data[]; // 柔性数组
};

扩展方案 #

如果有大量同类型结构体需要处理，可以基于反射封装通用序列化函数，自动识别结构体中的固定字段和切片字段，自动完成拆分序列化，无需每次手动写步骤。

注意事项 #

• 注意和C端约定结构体的内存对齐规则，若C端使用#pragma pack修改对齐粒度，Go侧也需要对应处理对齐填充
• 切片长度的字段类型必须和C端一致，避免32位/64位系统下类型长度不匹配的问题

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