binary.Write 和 binary.Read 的字节序必须显式指定且严格一致，错误会导致数据解析失败；struct 直接读写需避免 padding，推荐手动拆字段；Uvarint/Varint 无字节序概念，适用于变长编码。
binary.Write 写入时字节序由 binary.BigEndian 或 binary.LittleEndian 显式控制
Go 的 binary 包不自动推断字节序，所有序列化操作必须显式传入一个 binary.ByteOrder 实现。用错顺序会导致读写不一致——比如用 binary.BigEndian 写，却用 binary.LittleEndian 读，得到的数值完全错误。
-
binary.Write第二个参数必须是binary.BigEndian或binary.LittleEndian，不能省略或传 nil - 常见误写：
binary.Write(w, nil, x)—— 运行时 panic：panic: nil ByteOrder - 如果目标协议要求网络字节序（即大端），就固定用
binary.BigEndian；本地 CPU 字节序无关，别试图“自动适配” - 示例：把
uint32(0x12345678)按大端写入：var buf bytes.Buffer binary.Write(&buf, binary.BigEndian, uint32(0x12345678)) // buf.Bytes() == []byte{0x12, 0x34, 0x56, 0x78}
binary.Read 读取时字节序必须和写入时严格一致
读取失败往往不是因为数据损坏，而是字节序不匹配。尤其在解析二进制协议（如自定义报文、文件头）时，只要有一个字段读错，后续全乱。
- 错误现象：
binary.Read返回io.ErrUnexpectedEOF或读出值明显异常（如时间戳变成负数、长度字段为超大值），先检查字节序是否对得上 - 不要依赖
runtime.GOARCH判断该用哪个：x86_64 是小端，但协议可能强制大端；ARM 可能是小端或大端，跟 Go 运行时无关 - 建议把字节序变量提取为常量，避免硬编码：
const order = binary.BigEndian // 或 LittleEndian binary.Read(r, order, &header) binary.Read(r, order, &payloadLen)
- 注意：读取切片时，
binary.Read不处理元素字节序，只对基础类型（int32,uint64等）生效；数组/结构体需逐字段读，或用encoding/binary的Read+Write配合struct{}和binary.Read的反射限制（不推荐）
struct 要求字段对齐且无 padding 才能直接用 binary.Read/Write
Go struct 默认按字段大小对齐，编译器可能插入 padding 字节。一旦有 padding，binary.Read 会把填充字节当成有效数据读进去，导致字段错位。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 典型错误：定义
type Header struct { Magic uint16; Len uint32 }，在 64 位系统上Len前可能被插 2 字节 padding，实际内存布局 ≠ 期望的 6 字节 - 解决方法只有两个：
– 用//go:pack（不跨平台，慎用）
– 手动拆字段读写（推荐）：var magic uint16 var length uint32 binary.Read(r, order, &magic) binary.Read(r, order, &length)
– 或用unsafe.Sizeof+unsafe.Offsetof校验布局，但增加维护成本 - 没有“自动跳过 padding”的机制；
binary包永远按内存布局一字节一字节读，它不管语义
binary.Uvarint / binary.Varint 不涉及字节序选择，但要注意符号和长度可变
如果你看到“字节序转换”，但实际想做的是紧凑编码（比如 protobuf 的 varint），那 binary.Uvarint 和 binary.Varint 是另一条路——它们压根没有字节序概念，因为是 LEB128 编码，低位字节在前，固定规则。
立即学习“go语言免费学习笔记（深入）”；
-
binary.Uvarint用于无符号整数，binary.Varint用于有符号（zigzag 编码），二者都返回读取字节数和值 - 错误用法：
binary.Write(w, order, uint64(x)); binary.Uvarint(r)—— 类型不匹配，Uvarint期望的是变长字节流，不是固定长度的uint64序列 - 性能提示：varint 在小数值时极省空间（1 字节表示 0~127），但大数值可能比固定长度还占地方；不适合需要随机访问或确定偏移的场景
- 示例：
b := make([]byte, binary.MaxVarintLen64) n := binary.PutUvarint(b, 300) // b[:n] == []byte{0xac, 0x02} v, _ := binary.Uvarint(bytes.NewReader(b)) // v == 300
