深入理解 Go 中的字节序（Endianness）检测代码

Achilles.Wang

于 2025-06-11 09:13:44 发布

阅读量563

点赞数 8

分类专栏： go 文章标签： golang 开发语言后端

本文链接：https://blog.csdn.net/andrewgithub/article/details/148577203

版权

go 专栏收录该内容

47 篇文章

订阅专栏

深入理解 Go 中的字节序（大小端）检测代码

在这里插入图片描述

在计算机系统中，字节序（Endianness） 是指多字节数据类型（如 int16、int32 等）在内存中的存储顺序。Go 语言标准库提供了对大端（Big-endian）和小端（Little-endian）的支持，但在某些场景下，我们可能需要知道当前系统的字节序。

下面这段代码是一个经典的用于判断当前系统是否为小端（Little-endian）的实现：

import (  
    "encoding/binary"  
    "unsafe"
)  

// NativeEndian 是当前系统的字节序
var NativeEndian binary.ByteOrder  
  
func init() {  
    // 通过检查 int16 的内存布局来确定系统字节序
    var one int16 = 1  
    b := (*byte)(unsafe.Pointer(&one))  
    if *b == 0 {  
        NativeEndian = binary.BigEndian  
    } else {  
        NativeEndian = binary.LittleEndian  
    }  
}  
  
func NativelyLittle() bool {  
    return NativeEndian == binary.LittleEndian  
}

🧠 背景知识：什么是字节序？

大端（Big-endian）

高位字节在前，低位字节在后。
如 0x0102 存储为 [0x01, 0x02]
常见于网络协议（如 TCP/IP）

小端（Little-endian）

低位字节在前，高位字节在后。
如 0x0102 存储为 [0x02, 0x01]
常见于 x86/x86-64 架构的 PC

📜 逐行解析代码

导入依赖包

import (  
    "encoding/binary"  
    "unsafe"
)

"encoding/binary"：提供 binary.BigEndian 和 binary.LittleEndian 接口，用于处理字节序列化/反序列化。
"unsafe"：允许直接操作内存地址（不安全），用于获取 int16 的第一个字节。

定义全局变量

var NativeEndian binary.ByteOrder

定义一个全局变量 NativeEndian，它实现了 binary.ByteOrder 接口（即支持 PutUint16, Uint16 等方法）。
后续将根据系统实际字节序赋值为 binary.BigEndian 或 binary.LittleEndian。

初始化函数 `init()`

func init() {

init() 是 Go 的初始化函数，在包加载时自动执行。
通常用于初始化全局变量或配置环境。

设置测试值

var one int16 = 1

定义一个 int16 类型的变量 one，其值为 1。
在内存中，int16 占两个字节，具体如何排列取决于系统字节序。

获取内存地址的第一个字节

b := (*byte)(unsafe.Pointer(&one))

使用 &one 取出 one 的地址；
使用 unsafe.Pointer() 将其转换为一个通用指针；
再将其转换为指向 byte 的指针；
这样就可以访问 int16 的第一个字节。

⚠️ 注意：这属于“不安全”操作，仅在你知道自己在做什么时才使用。

判断是大端还是小端

if *b == 0 {
    NativeEndian = binary.BigEndian  
} else {
    NativeEndian = binary.LittleEndian  
}

如果第一个字节是 0x00，说明是 大端模式，因为 0x0001 表示为 [0x00, 0x01]
如果第一个字节是 0x01，说明是 小端模式，因为 0x0001 表示为 [0x01, 0x00]

提供判断函数

func NativelyLittle() bool {
    return NativeEndian == binary.LittleEndian  
}

返回一个布尔值，表示当前系统是否为小端模式。
可以用于后续逻辑判断，比如是否需要进行字节序转换。

🧪 示例用法

func main() {
    if NativelyLittle() {
        fmt.Println("当前系统是小端（Little-endian）")
    } else {
        fmt.Println("当前系统是大端（Big-endian）")
    }
}

输出：

当前系统是小端（Little-endian）

（大多数现代 PC 都是小端架构）

🔐 安全性与可移植性说明

使用 unsafe.Pointer 属于不安全操作，应谨慎使用；
此方法适用于底层开发、协议解析等需要了解系统字节序的场景；
不推荐在普通业务逻辑中使用；
若你希望兼容更多平台（如 ARM、MIPS 等），建议封装为统一接口。

✅ 总结

功能	说明
字节序检测	通过读取 `int16=1` 的内存布局判断系统字节序
`binary.ByteOrder` 接口	用于后续的二进制数据操作
`unsafe.Pointer`	直接访问内存地址，实现底层判断
`NativelyLittle()`	提供友好的 API 查询当前系统是否为小端