EncodeToString 必须传 []byte，不能传 string；它只接受字节切片，传字符串会编译失败，需显式转换为 []byte("hello")，且不支持 nil 切片，否则运行时 panic。
EncodeToString 必须传 []byte，不能传 string
Go 的 base64.StdEncoding.EncodeToString 函数只接受 []byte 类型输入，传 string 会直接编译失败。这不是疏漏，而是类型系统强制你明确“字节意图”。
常见错误写法：base64.StdEncoding.EncodeToString("hello") → 编译报错：cannot use "hello" (untyped string constant) as []byte value
- 正确写法是显式转换：
base64.StdEncoding.EncodeToString([]byte("hello")) - 中文、emoji、二进制头（如
\xff\xfe）都 OK，因为[]byte是原始字节视图，不依赖 UTF-8 解释 - 如果数据来自
json.Marshal或io.ReadAll，务必先检查err和len(data) > 0；空切片返回""，容易掩盖逻辑错误 - 别对已编码的 Base64 字符串再做
string(b)强转——EncodeToString输出本就是 ASCII 安全的字符串，可直接用
解码前必须清洗空白符并匹配编码器
base64.StdEncoding.DecodeString 对输入极其严格：首尾或中间任意位置的 \n、\r、\t、空格，都会触发 illegal base64 data at input byte X 错误。这不是数据损坏，而是格式校验失败。
典型场景：前端用 btoa() 编码后发来 JSON 字段，字段值末尾带换行；用户从 textarea 粘贴 Base64，混入不可见空格。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 第一步：用
strings.TrimSpace(input)清首尾空白，解决约 70% 的线上报错 - 第二步：确认编码器是否配套——
btoa()对应base64.StdEncoding；Buffer.from().toString('base64url')必须配base64.URLEncoding - 第三步：若来源不可靠（如表单输入），加一层全字符清洗：
clean := strings.Map(func(r rune) rune { if unicode.IsSpace(r) { return -1 }; return r }, input) - 长度非 4 倍数？仅对
StdEncoding场景补=：for len(clean)%4 != 0 { clean += "=" }
URL 安全场景必须用 base64.URLEncoding，不能手动替换
标准 Base64 的 + 和 / 在 URL 查询参数、JWT、文件名中会出问题：+ 被当空格，/ 被当路径分隔符，= 在某些网关里被截断。这时候不能靠 strings.ReplaceAll(s, "+", "-") 这类粗暴替换。
-
base64.URLEncoding用-替代+、_替代/，默认省略填充=，更紧凑也更安全 - 编码和解码必须全程配套：用
URLEncoding编，就必须用URLEncoding解，混用立刻报错 -
URLEncoding.DecodeString能容忍缺失的=，但不接受空格、中文、换行——仍需strings.TrimSpace - JWT payload 等明确要求“无填充”的场景，得用
base64.RawURLEncoding，否则解码失败
大文件必须用 NewEncoder / NewDecoder，Close 不可省
一个 50MB 的二进制文件，EncodeToString 会分配约 67MB 字符串，再 DecodeString 又要分配 50MB 切片——瞬时内存翻倍，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(enc, dstWriter), srcReader)——io.Copy内部会自动Close() - HTTP 上传场景中，可将
*multipart.Part直接传给base64.NewDecoder，实现边接收边解码
最常被忽略的是编码器匹配和 Close() 调用——前者导致解码直接失败，后者让数据悄悄变短，错误只在下游消费时才暴露。
