Go binary.ByteOrder.Append 怎样把整数追加到现有字节切片

想把定长整数追加到现有字节切片，直接写 buf = binary.BigEndian.AppendUint32(buf, value)。需要先澄清标题中的常见混称：binary.ByteOrder没有名为 Append 的方法；追加方法属于 binary.AppendByteOrder，名称是 AppendUint16、AppendUint32、AppendUint64。

BigEndian、LittleEndian 同时实现读取/覆盖写入和追加两类接口。它们能追加整数，但一个静态类型为 ByteOrder 的变量，不能因此直接调用追加方法。以下只讨论定长字段，不把它与变长整数编码混用。

官方文档地址：https://pkg.go.dev/encoding/binary

追加整数应调用哪个接口

追加已有缓冲区时，参数类型应表达“追加”的能力，而不是先收 ByteOrder 再盲目做类型断言。

// 只要求追加能力，调用者必须传入非 nil 的具体实现
func appendID(dst []byte, order binary.AppendByteOrder, id uint32) []byte {
    return order.AppendUint32(dst, id) // 返回值可能引用新的底层数组
}

片段需放在已导入 encoding/binary 的 Go 文件中。若同时需要读取和追加，可以自定义组合接口，嵌入 ByteOrder 与 AppendByteOrder；仅追加时不必扩大约束。不要假设所有第三方 ByteOrder 实现都带追加方法。

图中“标准实现”包含 BigEndian 和 LittleEndian，“能力接口”包含 ByteOrder、AppendByteOrder 与 AppendUint32；两种标准实现都满足两类接口，追加方法则属于 AppendByteOrder。

用已有前缀拼出定长消息

下面用两字节标记、两字节编号、四字节计数构造消息。字段布局是本文定义的示例协议，不是某个标准协议；接收端必须约定同样的顺序和字节序。

package main

import (
    "encoding/binary"
    "fmt"
)

func main() {
    buf := make([]byte, 0, 8) // 长度从零开始，容量容纳整条消息
    buf = append(buf, 0x4d, 0x52) // 原有两字节前缀
    buf = binary.BigEndian.AppendUint16(buf, 0x0312)
    buf = binary.BigEndian.AppendUint32(buf, 0x00010203)
    fmt.Printf("% x\n", buf) // 展示完整消息，而不是旧切片长度

    // 固定布局已知；真实外部输入应先检查长度
    id := binary.BigEndian.Uint16(buf[2:4])
    count := binary.BigEndian.Uint32(buf[4:8])
    fmt.Printf("编号=%d 计数=%d\n", id, count)
}

按字段定义推导，消息应为 4d 52 03 12 00 01 02 03，编号为 786，计数为 66051。这里是便于读者比较的预期字节，不声称示例已在本机执行。两次追加分别增加 2 与 4 字节，已有前缀仍位于开头。

注意 make([]byte, 8)表示已有八字节内容；在其后追加会把新字段放在这八个字节之后。需要预留容量但不制造占位内容时，使用三参数 make，让长度与容量分开表达。

为什么一定接住返回的切片

切片包含对底层数组的引用、长度 len 和容量 cap。追加之后返回切片的长度发生变化，底层数组也可能改变；原切片变量不会自动变成新的切片描述。无论容量是否足够，都应使用返回值。

// 保存返回切片，不依赖是否发生扩容
next := binary.LittleEndian.AppendUint16(buf, uint16(513))
buf = next
// 要保留独立副本时显式复制，而不是只复制切片描述
snapshot := append([]byte(nil), buf...)
_ = snapshot

“输入视图”中的原切片描述带有原长度；“返回视图”中的返回切片描述带有新长度。二者都可能关联同一底层数组，也可能关联不同数组。图中 len 和 cap 是描述属性，不代表额外内容；底层数组可能共享，不能把返回新切片误解为自动深拷贝。

把原切片交给别处保存后，自己继续追加，可能改动共享数组中仍可触达的内容。需要明确所有权；要独立保留快照就复制。并发读写共享数组还需要同步，追加方法本身不提供并发安全保证。

怎样选择字节序和字段宽度

大小端必须由协议约定，而不是“自己的机器是什么”。跨机器存储和网络消息不应随意选 NativeEndian。整数 0x1234 的大端字节是 12 34，小端字节是 34 12；变化的是字节排列，不是字段占用宽度。

外部数值先检查范围再转成 uint16 等类型；Go 的显式整数转换不会替你报告业务溢出。int 的机器相关宽度也不适合充当不加约束的线格式。AppendUint 系列适合已确定类型的单个字段，不负责把整个对象自动设计成稳定协议。

几个追加编码的常见问题

nil 切片能追加吗？

可以，把返回值保存即可。是否预分配容量属于分配策略，不改变协议字段含义，也不构成“零分配”的通用保证。

binary.Append 和 AppendByteOrder 是一回事吗？

不是。binary.Append 是包级函数，接收 ByteOrder 和数据并返回切片与错误；AppendByteOrder 是带定长无符号整数追加方法的接口。本文例子选择后者，避免把函数名、接口名、方法名混在一起。

能用 AppendUvarint 替代 AppendUint32 吗？

只有协议明确定义为变长编码才可以。定长四字节字段与变长整数不是可以直接互换的表示。

记住三件事：追加方法选 AppendByteOrder 能力、每次保存返回切片、按照协议固定字段宽度和字节序。接口名称写对，比给已有切片再手工拼临时缓冲区更容易维护。

参考：encoding/binary 接口文档、Go 官方实现。