Base64编码首选base64.StdEncoding.EncodeToString，输入必须为[]byte；解码须检查error且预估长度；自定义编码表需严格校验字符合法性；复用Encoding实例避免高频创建。
Base64 编码用 base64.StdEncoding.EncodeToString 最直接
多数场景下，你只是想把一段 []byte 变成可传输的 ASCII 字符串，比如发 HTTP 请求、存 JSON、拼接 URL 参数。这时候别绕弯，直接用标准编码器的 EncodeToString 方法就行。
它内部自动处理分块、填充（=），输出符合 RFC 4648 的 Base64 字符串。注意：它不接受 string 类型输入 —— Go 的字符串是只读字节序列，必须显式转成 []byte，否则编译报错。
-
base64.StdEncoding.EncodeToString([]byte("hello"))→"aGVsbG8=" - 如果传
"hello"（string）会编译失败：类型不匹配 - 若需 URL 安全变体（无
+//，用-/_），换用base64.URLEncoding
解码时必须检查 base64.DecodedLen 和错误
Base64 解码比编码“娇气”得多：输入稍有不合规（长度非 4 倍数、含非法字符、填充过多），DecodeString 就直接返回错误，不会“尽力而为”。很多人忽略这点，导致线上解析用户上传的 Base64 图片或 token 时 panic 或静默失败。
安全做法是先调用 base64.StdEncoding.DecodedLen 预估输出长度，再用 Decode（而非 DecodeString）配合预分配切片，避免重复内存分配；同时必须检查返回的 error，不能只看 len(dst)。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 错误示例：
base64.StdEncoding.DecodeString("aGVs")→illegal base64 data at input byte 4（长度不够） - 正确姿势：用
if decoded, err := base64.StdEncoding.DecodeString(src); err != nil { ... } - 若已知目标长度固定（如解密 AES 密文），提前用
make([]byte, base64.StdEncoding.DecodedLen(len(src)))分配空间
自定义编码表？小心 base64.NewEncoding 的字符合法性检查
极少数场景需要私有 Base64 表（比如避开某些过滤系统），得用 base64.NewEncoding。但它对传入的 64 字符字符串有硬性要求：必须由合法 Base64 字符组成（A–Z, a–z, 0–9, +, /, =），且不能重复 —— 否则运行时 panic：“invalid base64 encoding”。
更隐蔽的坑是：如果你从配置文件读取编码表字符串，中间混入不可见空格或换行符，NewEncoding 不会提示具体哪位非法，只会 panic。建议在初始化阶段就做校验。
-
base64.NewEncoding("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/")✅ 标准表 -
base64.NewEncoding("ABC...xyz0123456789+/ ")❌ 末尾空格触发 panic - 校验建议：遍历字符串，用
strings.ContainsRune("ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/", r)检查每个 rune
性能敏感时优先复用 base64.Encoding 实例
base64.StdEncoding 和 base64.URLEncoding 是包级变量，全局唯一、并发安全，直接用即可。但如果你自己调 base64.NewEncoding 创建了新实例，别每次编码都 new 一个 —— 它包含查找表和状态，构造成本不低，且无锁情况下并发调用可能出问题。
典型误用：在 HTTP handler 里每次请求都 base64.NewEncoding(...)，QPS 上千时 GC 明显升高。正确做法是定义为包级变量或结构体字段，在初始化时创建一次。
- ✅ 好：
var myEncoder = base64.NewEncoding("...")（包级） - ❌ 差：
func encode(x []byte) string { enc := base64.NewEncoding("..."); return enc.EncodeToString(x) } - 注意：
base64.StdEncoding等内置实例已优化过，无需包装或缓存
Base64 看似简单，但编码表校验、解码容错、实例生命周期这三处，最容易在压测或灰度时突然暴露。尤其是解码路径，永远别假设输入“应该”合法。
