Go base32.NewEncoding 怎么使用自定义字母表

base32.NewEncoding 的用法并不复杂：准备一个正好 32 字节、每个字节都不重复的字母表，传给函数得到 *base32.Encoding，之后编码和解码都使用这个对象。真正容易出错的是把“32 个字符”误解成“32 个 Unicode 字符”，或者发送端和接收端没有共享同一套字母表与填充规则。

Go 官方文档：https://pkg.go.dev/encoding/base32

先准备一个合法的字母表

Base32 每个输出符号承载 5 位信息，因此需要 32 个符号位置。下面采用常见的易读大写字母表，去掉容易混淆的 I、L、O、U，并保留 0 到 9。它恰好是 32 个互不重复的 ASCII 字节。

package main

import (
    "encoding/base32"
    "fmt"
)

const alphabet = "0123456789ABCDEFGHJKMNPQRSTVWXYZ"

func main() {
    // NewEncoding 会建立编码表和反向解码表
    enc := base32.NewEncoding(alphabet)

    // 编码和解码必须复用同一个 Encoding
    text := enc.EncodeToString([]byte("order-42"))
    raw, err := enc.DecodeString(text)
    if err != nil {
        fmt.Println("解码失败：", err)
        return
    }
    fmt.Printf("编码结果：%s，回环结果：%s\n", text, raw)
}

NewEncoding 对非法字母表采用 panic，而不是返回 error：长度不是 32 字节、包含重复字节或包含回车换行都会触发 panic。官方文档还要求字母表不要包含填充字符。生产项目通常把固定字母表声明为常量，在初始化阶段创建 Encoding，而不是把未经校验的用户输入直接交给它。

32 个字符不一定等于 32 个字节

Go 的实现把参数当作一串字节值，不会对 UTF-8 做特殊处理。32 个汉字通常远超 32 字节，因此不能直接作为字母表；即使某段 UTF-8 文本刚好是 32 字节，字节级拆分也很可能不符合人眼期望。最稳妥的做法是使用 32 个单字节 ASCII 符号。

字母表顺序同样属于协议的一部分。相同的输入字节在不同顺序下会得到不同文本；接收端如果使用标准 StdEncoding 解码自定义结果，要么报 CorruptInputError，要么得到错误数据。不要只把字母表写在某个服务的私有配置里，应该把它和协议版本一起固化。

按协议决定是否保留填充

NewEncoding 默认使用等号作为填充，使输出长度补齐到 8 的倍数。如果外部协议要求省略填充，可调用 WithPadding(base32.NoPadding)。该方法返回一个新的 Encoding，原对象不会被就地修改。

// 固定字母表与无填充规则必须由两端共同约定
var tokenEncoding = base32.
    NewEncoding("0123456789ABCDEFGHJKMNPQRSTVWXYZ").
    WithPadding(base32.NoPadding)

func encodeToken(src []byte) string {
    // 无填充只改变尾部格式，不会增加安全性
    return tokenEncoding.EncodeToString(src)
}

func decodeToken(s string) ([]byte, error) {
    // 解码端必须使用完全相同的字母表和填充设置
    return tokenEncoding.DecodeString(s)
}

上线前检查大小写与配置来源

自定义字母表的解码映射按字节精确匹配。若字母表只含大写字母，小写输入不会自动折叠成大写。需要大小写不敏感时，应在协议层规定统一输出形式，并在进入解码器前做受控规范化；不要同时把大小写版本放进字母表，因为这会挤占有限的 32 个位置。

如果字母表来自配置中心，建议先显式检查字节长度、重复值、CR/LF 和当前填充字符，再创建 Encoding。这样配置错误可以转成清晰的启动失败信息，而不是在业务请求期间突然 panic。还要为固定样例保存一组编码与解码向量，确保 Go 服务、其他语言客户端和历史数据使用的是同一版本。

常见问题

自定义字母表能隐藏原始数据吗？

只能让文本外观不同，不能提供保密性。知道字母表后即可还原；敏感数据仍应使用经过审查的加密和认证方案。

为什么 32 个中文字符会 panic？

因为函数检查的是字节长度，不是 Unicode 字符数量。UTF-8 中文字符通常占多个字节，整体长度不会等于 32。