在Go语言的二进制数据处理场景中，无符号16位整数的解析是常见需求，encoding/binary包提供了标准化的字节序处理能力，能够适配不同硬件架构和协议的数据格式要求。
字节序基础概念
字节序指的是多字节数据在内存中的存储顺序，主要分为两种类型：
- 大端序（BigEndian）：高位字节存储在低地址位置，符合人类阅读习惯，常见于网络协议、Java等场景。
- 小端序（LittleEndian）：低位字节存储在低地址位置，常见于x86、ARM等主流硬件架构。
如果解析时使用了错误的字节序，会得到完全错误的数值结果，因此明确数据的字节序类型是解析前的必要步骤。
encoding/binary包核心类型
encoding/binary包中定义了两个全局的字节序实例，无需额外初始化即可直接使用：
encoding/binary.BigEndian：大端序处理器encoding/binary.LittleEndian：小端序处理器
这两个实例都实现了binary.ByteOrder接口，该接口包含Uint16、PutUint16等方法，分别对应无符号16位整数的解析和写入。
解析无符号16位整数的具体方法
从字节切片解析
如果数据已经存储在字节切片中，可以直接调用ByteOrder的Uint16方法，该方法接收一个长度为2的字节切片作为参数，返回对应的无符号16位整数。
下面是不同字节序的解析示例：
package main
import (
"encoding/binary"
"fmt"
)
func main() {
// 定义两个字节的测试数据，值为0x1234
// 大端序存储时，第一个字节是0x12，第二个字节是0x34
bigEndianBytes := []byte{0x12, 0x34}
// 小端序存储时，第一个字节是0x34，第二个字节是0x12
littleEndianBytes := []byte{0x34, 0x12}
// 大端序解析
bigVal := binary.BigEndian.Uint16(bigEndianBytes)
// 小端序解析
littleVal := binary.LittleEndian.Uint16(littleEndianBytes)
fmt.Printf("大端序解析结果: %d, 十六进制: 0x%xn", bigVal, bigVal)
fmt.Printf("小端序解析结果: %d, 十六进制: 0x%xn", littleVal, littleVal)
// 错误字节序解析示例：用大端序解析小端序数据
wrongVal := binary.BigEndian.Uint16(littleEndianBytes)
fmt.Printf("错误字节序解析结果: %d, 十六进制: 0x%xn", wrongVal, wrongVal)
}
上述代码的输出结果为：
大端序解析结果: 4660, 十六进制: 0x1234 小端序解析结果: 4660, 十六进制: 0x1234 错误字节序解析结果: 13330, 十六进制: 0x3421
从流中解析
如果数据来自io.Reader类型的流（如网络连接、文件等），可以使用binary.Read方法，该方法会自动从流中读取对应长度的字节并完成解析。
示例如下：
package main
import (
"bytes"
"encoding/binary"
"fmt"
)
func main() {
// 模拟一个包含无符号16位整数的数据流，使用大端序
data := []byte{0x12, 0x34}
reader := bytes.NewReader(data)
var val uint16
// 从流中读取并解析大端序的无符号16位整数
err := binary.Read(reader, binary.BigEndian, &val)
if err != nil {
fmt.Printf("解析失败: %vn", err)
return
}
fmt.Printf("从流中解析的结果: %d, 十六进制: 0x%xn", val, val)
}
注意事项
- 调用
Uint16方法时，传入的字节切片长度必须至少为2，否则会触发运行时 panic。 - 使用
binary.Read方法时，目标变量的类型必须和要解析的数据类型匹配，解析无符号16位整数时目标变量需要是uint16类型。 - 如果不确定数据的字节序，需要先查看对应协议或数据格式的说明，避免盲目选择字节序导致解析错误。
字节序的选择完全由数据来源决定，和当前运行程序的硬件架构无关，即使程序运行在小端序的x86机器上，解析网络协议的大端序数据时也需要使用binary.BigEndian。
Go语言encoding_binary字节序无符号16位整数二进制解析修改时间：2026-07-11 00:06:24