核心是用显式字节流操作统一收发逻辑：明确双方字节序角色，严格按网络大端序处理TCP/IP字段；自定义协议需手动转换，封装EndianStream类型安全转换器；结构体字段级精准控制，禁用整体memcpy；发送/接收全程hex dump与Wireshark验证。
核心思路是：不依赖平台隐式行为，用显式、可验证的字节流操作统一收发逻辑。重点不在“转换”本身，而在于“在哪转、为何转、怎么验”。
明确通信双方的字节序角色
网络通信中必须区分「数据语义」和「传输约定」：
- TCP/IP 协议栈规定所有字段（IP地址、端口、长度、校验和）必须用大端序——这是强制标准，不是可选项
- 主机侧（x86/x64/ARM64）几乎全是小端，但你不能假设接收方也是小端；设备可能是 PowerPC、MIPS 或 DSP，它们默认大端
- 自定义协议若走 UDP/Raw Socket，没有协议栈自动转换，必须手动调用 htons/htonl 或等效逻辑
设计可复用的字节流类型转换器
避免零散调用 htons/htonl，封装为类型安全、带方向感知的转换器：
- 定义模板类 EndianStream，构造时传入目标序（
endian::big或endian::little），内部缓存当前主机序判断结果 - 提供
write_uint16(uint16_t v)方法：若目标序 ≠ 主机序，则先用htons(v)或位运算翻转，再逐字节写入 buffer - 提供
read_uint32()方法：从 buffer 读出 4 字节 → 组合成 uint32_t → 若主机序 ≠ 目标序，则调用ntohl()还原 - 对 float/double：先 memcpy 到 uint32_t / uint64_t，转换整型字节序后再 memcpy 回浮点变量
结构体字段级精准控制
禁止对整个 struct 使用 memcpy + 一次性翻转——字段对齐、填充字节、非整型成员都会导致崩溃或静默错误：
- 把协议结构体拆成「可序列化字段列表」，例如：
struct SensorPacket { uint16_t id; int32_t temp; uint8_t status; }; - 转换器只处理
id和temp，跳过status（单字节无序）；若结构体含数组或嵌套结构，递归调用对应 write/read 方法 - 发送前调用
stream.write(id).write(temp).write(status)；接收后按相同顺序id = stream.read_uint16(); temp = stream.read_int32(); ...
验证与调试不可省略
上线前必须实测字节流内容，而非仅验数值：
- 在发送端打印 hex dump：对
uint16_t x = 0x1234，调用htons(x)后应得0x12 0x34（大端），而非0x34 0x12 - 用 Wireshark 抓包，直接查看 TCP payload 的原始字节，确认 IP、端口、自定义字段是否符合大端排列
- 在接收端加断点，检查读出的 raw bytes 缓冲区内容，再比对转换后的数值是否与发送端原始值一致
