Go 里的字节序怎么用：从大端、小端到结构体转换

夏知夏

发布时间：2026-08-25 | 88人浏览过

原创

前言

在 Go 里处理二进制数据时，字节序往往不是最先注意到的问题，但它经常决定读出来的值到底对不对。本文从大端、小端的基本区别讲起，再结合 `encoding/binary` 的整数与结构体示例，说明在什么场景下必须显式指定字节序，以及该怎样判断读写规则是否一致。

在 Go 里处理网络协议、二进制文件或设备通信时，字节序是一个很容易被忽略、但一出错就很难排查的问题。很多时候数据本身没有错，真正出问题的是“这些字节应该按什么顺序解释”。下面就从大端、小端的基本概念讲起，再看 Go 标准库 `encoding/binary` 如何完成整数和结构体之间的字节序转换，帮助你判断什么时候该显式指定字节序。

什么是字节序

字节序，指的是一个多字节数据在计算机中存放时，以及输入、输出时各个字节的排列顺序。

常见的字节序主要分为两种：大端字节序和小端字节序。

小端字节序

小端字节序指一个数据单元在计算机中存放时，按照低位在低地址、高位在高地址的方式排列。

大端字节序

大端字节序指一个数据单元在计算机中存放时，按照低位在高地址、高位在低地址的方式排列。

如果只看定义，这两个概念往往比较抽象。更实用的理解方式是：同一个整数写成字节流后，大端通常按“高位字节在前”，小端则按“低位字节在前”。这也是二进制协议里最常见的差异来源。

Go 里用什么处理字节序

Go 语言中，字节序转换主要通过标准库 encoding/binary 完成。这个包适合处理固定长度的二进制数据，常见场景包括整数编码、结构体写入和从字节流中还原数据。

最常用的两种字节序实现分别是：

binary.BigEndian
binary.LittleEndian

实际使用时，只要在读写时明确指定其中一种，就能保证编码和解码遵循同一套规则。

整数在大端和小端下的表现

先看一个整数转换的例子。这里使用 int32 类型的 0x01020304，分别按大端和小端写入缓冲区：

用纸面卡片对比大端与小端的字节排列顺序，展示同一个 0x01020304 在两种字节序下的输出差异 — **同一个整数，为什么会写出两种字节顺序**同一个整数写入字节流后，大端与小端的差异主要体现在字节排列顺序。

    var i int32 = 0x01020304  // 十六进制表示

    buffer := new(bytes.Buffer)
    binary.Write(buffer, binary.BigEndian, i) // 大端字节序

    fmt.Printf("BigEndian: %x n", buffer.Bytes()) // 01020304

    buffer = new(bytes.Buffer)
    binary.Write(buffer, binary.LittleEndian, i) // 小端字节序

    fmt.Printf("BigEndian: %x n", buffer.Bytes()) // 04030201

这个例子说明了同一个数值在不同字节序下，会生成不同的字节排列结果：

大端输出：01020304
小端输出：04030201

也就是说，数值本身没有变，变化的是它被拆成多个字节后在字节流中的顺序。

这类差异在网络传输、跨语言通信、读取二进制文件时尤其关键。只要发送端和接收端对字节顺序的理解不一致，读出来的数据就会完全不同。

结构体也可以批量转换

除了基本整数，encoding/binary 也支持把结构体整体写入字节流，或者从字节流中按指定字节序读回结构体。

展示 Go 结构体通过 encoding/binary 写入字节流并按同一字节序读回的过程，用卡片和箭头说明 Name 与 Age 字段的固定布局 — **结构体与字节流如何按同一规则往返转换**结构体整体读写时，字段布局和读写字节序必须保持一致。

示例代码如下：

    type User struct {
        Name [30]byte
        Age  uint32
    }

    user := User{}
    copy(user.Name[:], "John Wilson")
    user.Age = 30

    buffer := new(bytes.Buffer)
    binary.Write(buffer, binary.BigEndian, &user) // 批量转为大端字节序

    var user1 User
    binary.Read(buffer, binary.BigEndian, &user1) // 批量转回结构体

这段代码展示了两个常见操作：