优先用base64.StdEncoding.EncodeToString()，它直接返回string；Encode()需手动分配足够长的目标切片，否则panic；URL安全场景应换用URLEncoding；解码前须TrimSpace并校验编码一致性，大文件推荐NewEncoder/NewDecoder流式处理。
Base64编码用base64.StdEncoding.EncodeToString()还是Encode()
直接用base64.StdEncoding.EncodeToString()最省心，它接收[]byte并返回string，适合大多数场景（比如HTTP头、JSON字段、URL安全无关的存储）。如果要用Encode()，得自己准备目标[]byte切片，长度必须≥base64.StdEncoding.EncodedLen(len(src))，否则会panic——这是新手常踩的坑。
示例：
data := []byte("hello world")
encoded := base64.StdEncoding.EncodeToString(data) // → "aGVsbG8gd29ybGQ="
注意：StdEncoding用+和/，不适用于URL或文件名；若需URL安全，换用base64.URLEncoding。
解码时base64.StdEncoding.DecodeString()报illegal base64 data
这个错误九成是因为输入字符串含空格、换行、BOM或非标准填充（比如多写了=，或漏了=）。Base64严格要求长度是4的倍数，且只含A-Z a-z 0-9 + / =（或- _，对应URLEncoding）。
立即学习“go语言免费学习笔记（深入）”；
常见修复方式：
- 用
strings.TrimSpace()先清理首尾空白 - 检查是否混用了编码变体（如前端用
URLEncoding，后端却用StdEncoding解） - 确认原始数据没被多次编码（比如“aGVsbG8=”再编码一次就失效）
安全解码建议加错误处理：
s := strings.TrimSpace(input)
decoded, err := base64.StdEncoding.DecodeString(s)
if err != nil {
// 处理非法输入，不要直接panic
}
大文件或流式数据别一次性读进内存
EncodeToString()和DecodeString()都要求整个数据在内存中。处理几MB以上的数据或HTTP Body时，容易OOM。此时应改用base64.NewEncoder()或base64.NewDecoder()配合io.Reader/io.Writer。
例如解码HTTP请求Body：
decoder := base64.NewDecoder(base64.StdEncoding, r.Body) _, err := io.Copy(outputWriter, decoder) // 流式解码，内存恒定
编码同理：encoder := base64.NewEncoder(base64.StdEncoding, w)，然后io.Copy(encoder, srcReader)。
自定义Base64字母表？小心base64.NewEncoding()的陷阱
如果需要私有编码（比如避开某些字符），可用base64.NewEncoding("your64chars")，但必须确保传入的字符串恰好64个**不同**字节，且不含+、/、=等特殊含义字符（除非你明确重定义语义）。更关键的是：标准库不会校验你的字母表是否可逆——如果Encode和Decode用的不是同一张表，结果必然错乱。
典型误用：
- 用
strings.ReplaceAll()临时替换+→.，却不改解码器——这不算自定义编码，只是字符串替换，应统一在编解码前后处理 - 字母表里重复字符（如两个
A），导致Decode随机选一个，结果不可预测
真正需要定制时，务必把同一*base64.Encoding实例复用于编码和解码两端，且测试双向可逆性。
