Go标准库encoding/base64提供高效安全的Base64编解码,支持标准与URL安全变种;基础编码用EncodeToString,解码需检查err;大文件推荐NewEncoder/NewDecoder流式处理。

Go 标准库 encoding/base64 提供了高效、安全的 Base64 编解码能力,特别适合处理二进制数据(如图片、加密密钥、JWT 载荷等)的文本化传输与存储。它不依赖外部依赖,且默认使用标准 Base64 字母表(A-Z a-z 0-9 + /),也支持 URL 安全变种。
基础编码:将字节切片转为 Base64 字符串
使用 base64.StdEncoding.EncodeToString() 可直接将 []byte 转为可读字符串,适合日志、HTTP 响应、配置序列化等场景。
示例:
data := []byte("hello world")
encoded := base64.StdEncoding.EncodeToString(data)
// 输出:aGVsbG8gd29ybGQ=
注意:EncodeToString 是便捷封装,底层调用 Encode 并自动分配目标缓冲区;若需极致性能或复用缓冲区,可用 Encode(dst, src) 手动管理 dst(长度至少为 base64.StdEncoding.EncodedLen(len(src)))。
立即学习“go语言免费学习笔记(深入)”;
基础解码:将 Base64 字符串还原为原始字节
使用 base64.StdEncoding.DecodeString() 解码字符串。该函数会校验填充(=)、字符合法性及长度是否符合 Base64 规则。
示例:
decoded, err := base64.StdEncoding.DecodeString("aGVsbG8gd29ybGQ=")
if err != nil {
log.Fatal(err)
}
// decoded == []byte("hello world")
常见错误包括:非法字符(如空格、换行)、缺少或多余填充符、长度非 4 的倍数。生产环境建议始终检查 err。
处理二进制文件(如图片、PDF)
Base64 常用于将二进制文件嵌入 JSON、HTML 或邮件中。推荐流式处理大文件,避免内存暴涨:
- 读取文件 →
io.ReadCloser→ 包装为base64.NewEncoder→ 写入目标(如os.Stdout或bytes.Buffer) - 解码时反向:用
base64.NewDecoder包裹输入源(如strings.NewReader(encoded)),再通过io.Copy流式写入文件
示例(编码文件):
f, _ := os.Open("avatar.png")
defer f.Close()
encoder := base64.NewEncoder(base64.StdEncoding, os.Stdout)
io.Copy(encoder, f) // 直接输出 Base64 流
encoder.Close() // 必须调用,确保末尾填充写入
URL 安全 Base64(无填充、用 -_ 替代 +/)
在 URL、文件名或 JWT 中,标准 Base64 的 +、/ 和 = 会引发问题。此时应使用 base64.URLEncoding:
- 字母表为
A-Z a-z 0-9 - _(无+和/) - 默认省略填充符
=(更紧凑),但解码时仍能容忍缺失或多余填充 - 编码后可直接拼入 URL path 或 query,无需额外 URL 编码
示例:
payload := []byte(`{"user":"alice","exp":1735689600}`)
encoded := base64.URLEncoding.EncodeToString(payload)
// 如:eyJ1c2VyIjoiYWxpY2UiLCJleHAiOjE3MzU2ODk2MDB9
不复杂但容易忽略:选择正确的编码变体、始终校验解码错误、大文件优先用流式接口。标准库已覆盖绝大多数需求,无需引入第三方包。










