base64编码解码需严格匹配stdencoding或urlencoding，流式编码必须调用close()，解码前须清洗空白字符；stdencoding等常量可直接使用，无需复用优化。
Base64编码时忘记指定StdEncoding或URLEncoding导致解码失败
Go 的 encoding/base64 包默认不提供全局单例，必须显式选择编码方案。直接用未初始化的变量或误用包级函数（比如幻想有 base64.Encode() 这种顶层函数）会编译报错或运行时 panic。
常见错误现象：undefined: base64.Encode；或解码时遇到 illegal base64 data at input byte X —— 很可能是因为编码用了 URLEncoding（无 +、/，用 -、_），但解码时用了 StdEncoding。
- 标准 Base64（HTTP/JSON 场景）：始终用
base64.StdEncoding - URL/文件名安全场景（如 JWT payload、查询参数）：必须用
base64.URLEncoding，它省略填充=且替换特殊字符 - 不要自己拼接字符串再调
DecodeString；如果原始数据来自 HTTP header 或 query，很可能已 URL-safe，硬套StdEncoding必炸
用base64.NewEncoder处理大文件流，却没调Close()导致末尾字节丢失
流式编码不是“写完就完”。base64.NewEncoder 内部有缓冲区，最后 1–3 字节可能卡在 buffer 里没刷出。不显式 Close()，输出就少几个字符，解码端直接失败。
使用场景：读取几十 MB 日志文件、上传的二进制 body、数据库 BLOB 导出 —— 任何不能全量加载进内存的 case。
立即学习“go语言免费学习笔记（深入）”；
- 务必对 encoder 调用
Close()，且检查返回 error：if err := enc.Close(); err != nil { /* handle */ } - 别把
enc.Write()和enc.Close()包在同一个defer里——defer在函数 return 后才执行，中间 panic 会导致 Close 被跳过 - 更稳妥写法：用
io.Copy+base64.NewEncoder组合，因为io.Copy内部会自动 Close writer（只要它实现了io.Closer）
src, _ := os.Open("big.bin")
dst, _ := os.Create("big.b64")
enc := base64.NewEncoder(base64.StdEncoding, dst)
io.Copy(enc, src) // 自动 Close enc
src.Close()
dst.Close()
解码时传入含空格、换行或多余等号的字符串，DecodeString直接panic
base64.DecodeString 对输入极其严格：不允许任何空白符（包括 \n、\r、\t、空格），也不接受多于必要数量的填充 =。API 文档写的是 “strict”，真·严格。
使用场景：从 HTML 表单提交、邮件正文、用户粘贴的 Base64 片段中读取数据 —— 这些来源几乎必然带换行或空格。
- 先用
strings.TrimSpace干掉首尾空白 - 用
strings.Map或正则删掉所有中间空白：clean := strings.Map(func(r rune) rune { if unicode.IsSpace(r) { return -1 }; return r }, raw) - 填充校验可选，但建议做：Base64 长度必须是 4 的倍数，不足则补
=；不过URLEncoding允许省略=，所以优先用对应 encoding 的DecodeString - 永远用
if decoded, err := enc.DecodeString(clean); err != nil { ... }检查 error，别假设能 decode 成功
在 HTTP handler 中复用base64.StdEncoding实例，以为能提升性能？其实没必要
base64.Encoding 是只读结构体，内部无锁、无状态，StdEncoding 和 URLEncoding 都是包级常量，本身就是线程安全的全局值。所谓“复用实例”纯属过度优化，还容易引发误解。
性能影响：每次调 StdEncoding.EncodeToString 开销约 20–50 ns，瓶颈从来不在这里，而在 I/O 或 GC。真正该关注的是别在 hot path 上反复 make([]byte, ...) 分配底层数组。
- 直接用
base64.StdEncoding.EncodeToString(b)，干净、明确、无副作用 - 如果真要极致控制内存（比如高频小数据 encode），可预分配
dst切片并用Encode方法：dst := make([]byte, base64.StdEncoding.EncodedLen(len(src))); base64.StdEncoding.Encode(dst, src) - 别为省一个点号去定义局部变量
var b64 = base64.StdEncoding——代码更啰嗦，语义没变，还占个符号名
实际写流式工具时，最易漏的是 encoder 的 Close() 和输入字符串的空白清洗 —— 这俩问题不会在小测试用例里暴露，一到真实数据就断在解码端，而且错误信息完全不指向根源。
