Go math/bits.ReverseBytes16 怎样交换整数的高低字节

处理二进制协议、硬件寄存器或定长整数时，如果只需要把一个 uint16 的高低字节互换，可以直接调用 math/bits.ReverseBytes16。例如 0x1234 会变成 0x3412；它交换的是两个字节，不是把 16 个 bit 全部倒序。

官方地址：https://pkg.go.dev/math/bits#ReverseBytes16

ReverseBytes16 的输入和输出都是 uint16，调用简单、边界明确。先确认协议需要的是“字节交换”，再决定是否在序列化入口统一处理一次。

先分清字节交换和位反转

ReverseBytes16(x) 返回 x 的两个字节互换后的值。把 0x1234 写成两个字节就是 0x12、0x34，交换后得到 0x34、0x12，重新组成整数便是 0x3412。

它和 bits.Reverse16 不是一回事：后者会把每一个 bit 的顺序倒过来。例如低位的 1 可能移动到最高位。需求如果是处理大端、小端字段，通常要的是字节交换，而不是位反转。

package main

import (
    "fmt"
    "math/bits"
)

func main() {
    value := uint16(0x1234)
    // 只交换两个字节，不改变 uint16 的位宽。
    swapped := bits.ReverseBytes16(value)
    fmt.Printf("0x%04x -> 0x%04x\n", value, swapped)
}

保留 uint16 类型很重要：它让调用者知道这里只处理 16 位无符号值，避免先转成平台相关的 int 后再猜测哪些位有效。

把交换放在协议字段的明确边界

在协议代码里，建议把字节序转换放在“读出字段”和“进入业务值”之间，并在项目中约定只转换一次。下面的辅助函数表达了一个常见边界：外部字段已经被组装成 uint16，业务层需要另一种字节顺序。

package main

import "math/bits"

func normalizeWord(raw uint16, needSwap bool) uint16 {
    // 只有协议明确要求交换时才转换，避免调用方重复处理。
    if !needSwap {
        return raw
    }
    return bits.ReverseBytes16(raw)
}

needSwap 不应由一次调用临时猜测，而应来自协议版本、设备配置或明确的字段约定。若读取层已经使用了对应字节序的 encoding/binary 方法完成转换，业务层就不要再次调用 ReverseBytes16。

相邻 API 怎么选

官方文档还说明这些字节反转函数的执行时间不依赖输入。这个性质适合把它当作明确的整数变换使用，但不能据此推断整个网络读取或序列化流程具有相同的性能特征。

常见问题

ReverseBytes16 会修改原变量吗？

不会。Go 的参数按值传递，函数返回交换后的新值；需要保留结果时显式赋值即可。

为什么结果看起来像“高低位反了”？

十六进制显示把两个字节写在一起，0x1234 变成 0x3412 是字节位置互换；如果要判断 bit 是否倒序，应使用 Reverse16 的语义来比较。

已经用 binary.Read 读取后还要交换吗？

先确认读取时使用的 ByteOrder。如果解码步骤已经按协议字节序得到业务整数，再次交换通常会把结果变回错误顺序。