Go 的 Base64 编解码需用 encoding/base64 包,输入必须为 []byte,推荐 StdEncoding(标准)或 URLEncoding(URL 安全,用 -/_ 替代 +/,省略 =),解码务必检查 error,避免编码类型混用。

Go 语言标准库 encoding/base64 提供了简单高效的 Base64 编码与解码能力,无需额外依赖。核心是使用预定义的编码器(如 StdEncoding 或 URLEncoding),调用 EncodeToString 和 DecodeString 即可完成常见操作。
基础编码:字节切片 → Base64 字符串
Base64 编码输入必须是 []byte,输出为字符串。推荐使用 base64.StdEncoding(RFC 4648 标准,含 +、/ 和 =):
- 调用
base64.StdEncoding.EncodeToString([]byte("hello"))得到"aGVsbG8=" - 注意:不能直接传字符串,需先转为字节切片(
[]byte(s)) - 若处理二进制数据(如图片),直接传入原始字节即可
基础解码:Base64 字符串 → 字节切片
解码需处理可能的错误(比如非法字符、长度不对、填充缺失等),务必检查返回的 error:
data, err := base64.StdEncoding.DecodeString("aGVsbG8=")- 成功时
data是[]byte{104, 101, 108, 108, 111},即[]byte("hello") - 错误常见原因:字符串含空格、换行、大小写混用,或缺少填充(
=)
URL 安全编码(无 + / =)
在 URL、文件名或 JSON 中传输 Base64 时,应避免 +、/ 和 =。改用 base64.URLEncoding:
立即学习“go语言免费学习笔记(深入)”;
-
base64.URLEncoding.EncodeToString([]byte("hi!"))→"aGkhIQ=="(标准)→ 实际输出为"aGkhIQ"(自动省略=) - 它用
-替代+,_替代/,且不强制填充(但解码时仍支持带/不带=) - 解码统一用
URLEncoding.DecodeString,兼容有无填充的输入
编码器复用与自定义(进阶)
高频场景下可复用编码器对象提升性能;也可自定义字符集(如用于 legacy 协议):
- 预定义常量已足够:优先用
StdEncoding、URLEncoding、RawStdEncoding(无填充) - 自定义编码表需用
NewEncoding(string),传入 64 字符字符串(如"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/") - 一般业务无需自定义,出错多因误用编码/解码对(例如用 StdEncoding 解 URLEncoding 结果)
基本上就这些。记住关键点:输入是字节、检查解码 error、URL 场景换 URLEncoding、别混用编码类型 —— Base64 在 Go 里真的不复杂但容易忽略细节。










