boltdb按字节序对键进行字典序排序，要使整数型键（如id）的排序结果与数值大小顺序一致，必须统一采用bigendian序列化，否则littleendian会导致高位字节后置，破坏自然序。
boltdb按字节序对键进行字典序排序，要使整数型键（如id）的排序结果与数值大小顺序一致，必须统一采用bigendian序列化，否则littleendian会导致高位字节后置，破坏自然序。
在BoltDB中，键（key）的排序完全依赖其字节序列的字典序（lexicographic order）——即逐字节比较 []byte 的二进制值，而非解析为整数后的数值大小。这意味着：若将整数 1、256、65536 直接用 strconv.Itoa() 转为字符串 "1"、"256"、"65536" 作为键，虽可排序，但属于字符串排序（"1" < "256" < "65536"），不适用于范围扫描或分页；而若用二进制序列化，则必须确保字节布局能映射数值大小关系。
✅ 正确做法：使用 binary.BigEndian
// 推荐：BigEndian 确保字典序 == 数值序 var keyBuf [8]byte binary.BigEndian.PutUint64(keyBuf[:], uint64(id)) // id=1 → [0,0,0,0,0,0,0,1] // id=256 → [0,0,0,0,0,0,1,0] → 字典序排在 id=1 之后 ✅
❌ 错误示例：binary.LittleEndian
binary.LittleEndian.PutUint64(keyBuf[:], uint64(1)) // → [1,0,0,0,0,0,0,0] binary.LittleEndian.PutUint64(keyBuf[:], uint64(256)) // → [0,1,0,0,0,0,0,0] // 字典序：[0,1,...] < [1,0,...] ⇒ 256 的键排在 1 前面 ❌ 违反预期
? 原理说明：
立即学习“go语言免费学习笔记（深入）”；
- BigEndian 将最高有效字节（MSB）置于最前，因此 uint64(1) 和 uint64(256) 的前缀差异出现在高位字节，字典序天然反映数值大小；
- LittleEndian 将最低有效字节（LSB）前置，导致小数值可能以 0x01 开头，大数值反而以 0x00 开头，彻底打乱顺序。
? 实际建议：
- 永远不要依赖机器本地字节序（runtime.GOARCH 或 unsafe.Sizeof 判断），BoltDB数据库需跨平台可移植，且排序逻辑必须确定性；
- 对复合结构（如题中 Key{Head, Mark, Counter}），应按字段重要性从高到低依次写入 BigEndian 字段，例如：
func (k Key) Bytes() []byte { buf := make([]byte, 8) binary.BigEndian.PutUint32(buf[0:], k.Head) // 4字节 binary.BigEndian.PutUint16(buf[4:], k.Mark) // 2字节 binary.BigEndian.PutUint16(buf[6:], k.Counter) // 2字节 return buf } - 若需时间戳排序，推荐 binary.BigEndian.PutUint64(buf[:], uint64(t.UnixNano()))，而非 t.Format("20060102150405") 字符串（易受时区/格式影响）。
⚠️ 注意事项：
- BoltDB 不提供自动类型感知排序，所有键均为裸 []byte，序列化方式完全由应用层控制；
- 使用 Cursor.Seek() 或 Cursor.First()/Last() 进行范围查询时，错误的字节序将导致 Seek([]byte{0,0,0,1}) 找不到紧邻的下一条记录；
- 若已误用 LittleEndian 写入数据，无法通过读取修复顺序——必须全量迁移并重写键。
总结：BigEndian 是 BoltDB 整数键排序的黄金标准。它不依赖硬件、保证跨平台一致性，并让 bytes.Compare(k1, k2) == 0 当且仅当 k1 == k2 数值相等，是构建可靠范围查询、分页和有序遍历的底层基石。
