base64.StdEncoding.EncodeToString最常用但需传[]byte而非string；解码前必须用strings.TrimSpace和strings.Map清洗空白符并补足=；大文件应使用NewEncoder/NewDecoder流式处理；编码器选择须与使用场景严格匹配。
base64.StdEncoding.EncodeToString 是最常用、最直接的编码方式，但必须传 []byte，不能传 string；解码时 base64.StdEncoding.DecodeString 会严格校验输入，不清洗就调用几乎必报错。
编码：别传 string，也别忘选对编码器
Go 的 EncodeToString 只接受 []byte。写 base64.StdEncoding.EncodeToString("hello") 会编译失败——类型不匹配。正确写法是 base64.StdEncoding.EncodeToString([]byte("hello"))。
你还要选对编码器：
- HTTP body、JSON 字段、邮件 MIME → 用
base64.StdEncoding（含+和/） - URL 查询参数、JWT payload、文件名嵌入 → 必须用
base64.URLEncoding（用-和_替代，通常无=） - 若对接嵌入式设备或旧协议，可能省略填充 → 试试
base64.RawStdEncoding（完全忽略=）
混用编码器是线上解码失败的头号原因：前端用 btoa()（对应 StdEncoding），后端却用 URLEncoding 解，立刻报 illegal base64 data at input byte X。
解码前必须清洗字符串
DecodeString 对空白符零容忍：首尾的 \n、\r、\t、空格，中间任意位置的换行或空格，都会导致 panic 或返回错误。它甚至不接受多于必要的 =。
立即学习“go语言免费学习笔记（深入）”；
安全做法是先清洗：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 用
strings.TrimSpace(input)去首尾空白 - 若来源不可靠（如用户粘贴、HTML 表单），再加一步：
clean := strings.Map(func(r rune) rune { if unicode.IsSpace(r) { return -1 }; return r }, input)删所有空白符 - 长度非 4 倍数？标准 Base64 需补
=：for len(clean)%4 != 0 { clean += "=" }（仅限StdEncoding场景）
别用 strings.ReplaceAll(s, " ", "+") 这类粗暴替换——URL 安全变体里根本没 +，该用 URLEncoding 就得全程用它。
大文件别用 EncodeToString/DecodeString
一个 50MB 的二进制文件，Base64 编码后约 67MB 字符串，再解码又要分配一块 50MB 的 []byte —— 瞬时内存翻倍，GC 压力陡增，还容易 OOM。
改用流式处理：
- 编码：用
base64.NewEncoder(enc, writer)包装目标io.Writer，写完必须调enc.Close()，否则末尾 1–3 字节丢失 - 解码：用
base64.NewDecoder(enc, reader)包装源io.Reader（如strings.NewReader(s)），再用io.Copy(dst, dec) - 更省心组合：
io.Copy(base64.NewEncoder(...), src)，io.Copy会自动Close编码器
注意：NewEncoder 不会报错在 Write 时，所有错误都攒到 Close() 才返回，所以 Close() 的 error 一定要检查。
自定义编码表？先校验字符合法性
极少数场景需要私有 Base64 表（比如绕过内容过滤），得用 base64.NewEncoding("...")。但它对输入字符串有硬性要求：
- 必须恰好 64 个字符
- 每个字符必须是合法 Base64 字符：
A–Z、a–z、0–9、+、/、=（注意：URL 安全变体的-和_不在此列，需自己保证语义一致） - 不能有重复字符，也不能含不可见空格或换行符（从配置读取时极易中招）
建议初始化阶段就做校验：if len(table) != 64 || !isValidBase64Table(table) { panic("invalid base64 table") }，否则运行时 panic 只报 “invalid base64 encoding”，不指明哪位出错。
