Go语言base64编解码必须传[]byte而非string，解码前需strings.TrimSpace清洗空白符并严格匹配StdEncoding或URLEncoding编码器，大文件须用NewEncoder流式处理且显式调用Close()。
Go 语言没有叫 Encode 的全局加密函数，也没有内置的“流式加密函数”——所谓“Encode”在标准库中只对应编码（如 Base64、JSON），不是加密；真要加密得用 crypto/aes、crypto/rsa 等包，且必须自己组合 cipher 模式和随机数。
为什么找不到 base64.Encode 或 json.Encode 这样的函数
Go 标准库不提供顶层函数式调用：
-
base64.StdEncoding.EncodeToString是方法，不是函数；必须通过*base64.Encoding实例调用，不能直接base64.Encode(...) -
json.Marshal是函数，但json.Encoder是类型，要用json.NewEncoder(w).Encode(v)，没有单独的json.Encode - 所有“Encode”相关操作都强调显式选择编码器（如
StdEncodingvsURLEncoding）和目标（io.Writer或[]byte）
base64.NewEncoder 流式写入必须调用 Close()
漏掉 Close() 会导致末尾 1–3 字节丢失，解码端直接报 illegal base64 data：
- 流式编码（如大文件转 Base64）必须用
base64.NewEncoder(enc, w)+io.Copy(enc, r)，或手动Write后显式enc.Close() -
defer enc.Close()不可靠：若前面 panic，defer不执行；更稳妥的是io.Copy，它内部会自动Close实现了io.Closer的 writer - 错误示例：
enc.Write(data); return—— 输出截断，无错误提示，但解码失败
想“流式加密”二进制数据？别用编码器，用 cipher.Stream
Base64 是编码，不是加密；真正流式加解密需自行组装对称密码流：
立即学习“go语言免费学习笔记（深入）”；
- AES-CTR 或 XOR 流密码可逐段处理：
aes.NewCipher→cipher.NewStream→stream.XORKeyStream(dst, src) - 不要把
base64.NewEncoder和加密混用：先加密再 Base64 编码是常见组合，但二者职责分离 - 注意：GCM 等认证模式不支持纯流式（需要完整输入算 tag），若必须流式且带完整性校验，得用
crypto/cipher.AEAD分块封装并管理 nonce
最易被忽略的一点：所有“流式”操作（json.Encoder、base64.NewEncoder、cipher.Stream）都不自动 flush，也不自动 close，靠你控制生命周期——这不是设计缺陷，而是 Go 明确把资源责任交还给使用者。
