Python如何将自定义类实例编码为适配C++结构体的可传输字节流

要实现和Go代码中binary.Write（小端序写裸结构体）完全一致的输出，直接对接C++端的结构体解析，完全可以靠Python标准库实现，不需要第三方依赖，生成的字节流无任何额外元数据，符合裸二进制结构体的传输要求。

推荐实现：使用struct标准库 #

struct模块的打包行为和Go的encoding/binary逻辑完全对齐，是这种跨语言结构体对接的最常用方案。

• 格式串匹配规则：
  • < 代表使用小端字节序，关闭结构体内存对齐填充，和Go代码里的binary.LittleEndian行为完全一致
  • I 对应无符号32位整数，刚好匹配C++的uint32_t类型，两个顺序排列的I就对应Header结构体的id、len两个字段
• 完整代码：

import struct

class Header:
  def __init__(self, id, len):
    self.id = id
    self.len = len

h = Header(1, 10)

# 打包为可直接传输的bytes
# 格式串'<II' 含义：小端序、无对齐、连续两个uint32字段
h_bytes = struct.pack('<II', h.id, h.len)

生成的h_bytes固定为8字节，内容为b'\x01\x00\x00\x00\x0a\x00\x00\x00'，和Go代码输出的字节序列完全一致，可直接通过socket写入Unix域套接字。C++端只要读取到这8字节，直接将内存强制转换为对应的Header结构体，就能正确解析出字段值，不存在兼容问题。

备选实现：ctypes结构体映射 #

如果后续Header结构体的字段变多，可以直接通过ctypes定义和C++内存布局完全对齐的结构体，减少手写格式串出错的概率：

from ctypes import LittleEndianStructure, c_uint32

# 定义小端布局的结构体，关闭内存对齐填充
class CHeader(LittleEndianStructure):
    _pack_ = 1
    _fields_ = [
        ("id", c_uint32),
        ("len", c_uint32),
    ]

# 绑定实例值，直接转成可传输的bytes
c_h = CHeader(id=h.id, len=h.len)
h_bytes = bytes(c_h)

该方式生成的字节流和struct实现的输出完全等价。

对接注意事项 #

• 必须固定使用小端字节序打包，和Go侧的实现保持一致，如果用默认主机序、大端序，会导致C++端解析时字段值完全错位
• 要关闭结构对齐填充，保证两个uint32字段连续排列，总长度固定为8字节，和Go裸写的行为对齐，避免因填充字节导致后续读取的长度偏移
• 不要用pickle做序列化：pickle是Python专属的带元数据的序列化格式，会额外写入类标识、长度标记等冗余内容，完全不匹配C++端的裸结构体解析逻辑，这也是之前pickle对接失败的核心原因。

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