Go encoding/hex 怎么把固定宽度字节转成可比较字符串

在做缓存键、对象摘要或日志字段时，常见要求是：一组固定长度的字节，输出成长度稳定、大小写统一、可以直接排序的字符串。Go 里用 encoding/hex 就能完成这件事。关键规则只有一个：N 个字节会得到 2N 个十六进制字符，并且标准编码结果使用小写字母。

固定宽度首先要从字节长度算出来

假设业务字段是 16 字节的二进制标识，它的十六进制文本应始终是 32 个字符。不要先把字节转成整数再格式化：整数格式化容易丢掉开头的 0，而十六进制键一旦长度不一致，字符串排序和前缀匹配都会出现难以排查的差异。

encoding/hex 提供两种常用写法：已经有字符串结果时使用 EncodeToString 最直接；需要复用缓冲区时使用 EncodedLen 分配目标空间，再调用 Encode。

EncodeToString 和 Encode 怎么选

小型字段、缓存键和 JSON 摘要通常选择 EncodeToString，代码短且不需要手动管理目标切片。批量编码或热路径可以使用 Encode，把目标切片一次分配好，避免每次都额外创建中间对象。

package main

import (
    "encoding/hex"
    "fmt"
)

func main() {
    var id [6]byte = [6]byte{0x00, 0x0a, 0x10, 0x2f, 0xa0, 0xff}

    // 数组转切片后编码，前导零会被保留。
    textKey := hex.EncodeToString(id[:])

    // 显式分配 2*N 个字节，适合复用缓冲区的场景。
    dst := make([]byte, hex.EncodedLen(len(id)))
    written := hex.Encode(dst, id[:])

    fmt.Println(textKey, len(textKey))
    fmt.Println(string(dst[:written]))
}

这个例子的结果是同一个小写字符串，长度为 12。[6]byte 不能直接传给接收 []byte 的函数，所以要使用 id[:]；这不是编码规则，而是数组与切片类型的区别。

可比较不等于可以忽略大小写

十六进制字符按字符顺序比较时，统一的字符表很重要。标准 encoding/hex 编码使用 0123456789abcdef，所以同一个字节序列不会一会儿生成大写、一会儿生成小写。不要在入库前随机调用 strings.ToUpper，也不要把外部传入的大写和内部生成的小写混在同一个键空间。

如果比较的是两个已经编码的文本，长度相同且采用同一字符表时，字典序与逐字节序一致。例如 0001ff 会排在 0002ff 前面；前导零不是装饰，而是保证位宽一致的一部分。

什么时候应该比较原始字节

如果目标只是生成展示值、日志字段或可读缓存键，比较编码后的字符串很方便；如果目标是安全校验、签名验证或避免比较时序差异，就不要把“可排序”当成“安全比较”。这类场景应保留原始字节，并按对应协议使用专门的比较函数。

解码外部文本时也要检查错误：十六进制字符串必须是偶数长度，并且只能包含合法字符。不要因为拿到了部分字节就继续当成完整标识使用。

func decodeKey(s string) ([]byte, error) {
    // DecodeString 会拒绝奇数长度或含非法字符的输入。
    raw, err := hex.DecodeString(s)
    if err != nil {
        return nil, fmt.Errorf("invalid hex key: %w", err)
    }
    return raw, nil
}

按场景做最后选择

最终可以用三项检查收尾：输入字节数是否符合协议、输出长度是否等于字节数的两倍、所有入口是否都使用同一种大小写策略。这样生成的十六进制字符串才真正适合做稳定的比较键。

相关问题

为什么不能用 fmt.Sprintf("%x", data)？

它也能得到十六进制文本，但本文场景更适合直接使用标准库的明确 API；需要固定宽度时，先确认输入字节数和 hex.EncodedLen，比依赖格式化字符串更容易维护。

大写和小写十六进制能直接比较吗？

不要混用。先在系统边界统一编码策略；如果必须接受外部大小写，先规范化，再进入缓存键、索引或排序逻辑。