hex.encodetostring 直接将 []byte 转为小写十六进制字符串;若输入是 string,需先转为 []byte(s) 再编码,避免误编码 utf-8 字节;hex.decodestring 为其逆操作,要求输入偶长、纯十六进制字符,需校验 error 并清理空格和前缀。

hex.EncodeToString 怎么把 []byte 转成十六进制字符串
直接用 hex.EncodeToString,它专为这个场景设计,输入是 []byte,输出是标准小写十六进制字符串(如 "68656c6c6f")。
常见错误是传入 string 类型——Go 里 string 不是字节切片,得先转:[]byte(s);否则会编码字符串的 UTF-8 字节,不是你预期的原始数据。
- 如果原始数据是
[]byte,直接传:hex.EncodeToString(data) - 如果原始是
string,且你想按其 UTF-8 字节编码:先转[]byte(s),再 encode - 如果原始是
string,但内容本身就是十六进制(如"a1b2"),别用这个函数——那是解码场景,该用hex.DecodeString - 结果永远是小写;没有内置大写选项,要大写得额外调用
strings.ToUpper
hex.DecodeString 怎么把十六进制字符串转回 []byte
hex.DecodeString 是 EncodeToString 的逆操作,但更敏感:输入必须是偶数长度、只含十六进制字符(0-9a-fA-F),否则返回 error。
典型报错是 "encoding/hex: invalid byte" 或 "odd length hex string",基本都源于字符串被意外截断、含空格、换行或大小写混用(其实大小写都支持,但字母必须合法)。
- 确保输入字符串长度为偶数;奇数长度直接 panic 或 error(取决于 Go 版本,1.22+ 返回 error)
- 提前清理空白符:
strings.TrimSpace(s),尤其从 HTTP header、JSON 或用户输入读取时 - 不校验前缀:
"0x"或"0X"会被当作非法字符,必须手动去掉 - 返回值是
[]byte, error,务必检查 error;忽略它会导致后续 panic 或静默数据损坏
想避免内存拷贝?试试 hex.Encoder 和 hex.Decoder
高频编解码(比如处理大量日志、网络包)时,反复调用 EncodeToString / DecodeString 会分配新字符串和切片,GC 压力明显。这时该用流式接口:hex.Encoder 和 hex.Decoder。
它们包装 io.Writer / io.Reader,复用底层 buffer,适合管道场景(如 HTTP body 编码、文件流处理)。
-
hex.NewEncoder(w io.Writer)写入时自动 hex 编码,w可以是bytes.Buffer或网络连接 -
hex.NewDecoder(r io.Reader)读取时自动 hex 解码,r 可以是strings.NewReader(s) - 注意:Decoder 对输入格式要求同
DecodeString,非法字符仍会返回 error - 没额外性能魔法——只是省掉中间字符串分配,真正省的是 GC 压力,不是单次耗时
为什么 bytes.Equal(hex.DecodeString(s), data) 有时失败
表面看是“解码后跟原数据比对”,但失败往往卡在三个隐形环节:编码前的数据来源、字符串是否带空格、以及 Go 的字节比较语义。
最常被忽略的是:你用来 encode 的 data 和 decode 后比对的 data,根本不是同一份内存或同一时刻的值。比如结构体字段被修改、切片被 reslice、或者用了 unsafe.Slice 等非标准构造方式。
- 确认两端数据完全一致:打印
fmt.Printf("%x", data)和解码后结果,逐字节核对 - 警惕字符串隐式转换:
string([]byte{0xff})在 UTF-8 下是非法,可能被替换为0xefbfbd(),导致 encode 结果失真 -
bytes.Equal比较的是字节,不是字符串;如果一端是string,另一端是[]byte,记得统一转成[]byte - Hex 编码本身无损,但流程中任意一环引入截断、trim、replace,都会让最终比对失效
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











