17370845950

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

Go 语言标准库 encoding/base64 提供了简单高效的 Base64 编码与解码能力,无需额外依赖。核心是使用预定义的编码器(如 StdEncodingURLEncoding),调用 EncodeToStringDecodeString 即可完成常见操作。

基础编码:字节切片 → 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

  • base64.URLEncoding.EncodeToString([]byte("hi!"))"aGkhIQ=="(标准)→ 实际输出为 "aGkhIQ"(自动省略 =
  • 它用 - 替代 +_ 替代 /,且不强制填充(但解码时仍支持带/不带 =
  • 解码统一用 URLEncoding.DecodeString,兼容有无填充的输入

编码器复用与自定义(进阶)

高频场景下可复用编码器对象提升性能;也可自定义字符集(如用于 legacy 协议):

  • 预定义常量已足够:优先用 StdEncodingURLEncodingRawStdEncoding(无填充)
  • 自定义编码表需用 NewEncoding(string),传入 64 字符字符串(如 "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/"
  • 一般业务无需自定义,出错多因误用编码/解码对(例如用 StdEncoding 解 URLEncoding 结果)

基本上就这些。记住关键点:输入是字节、检查解码 error、URL 场景换 URLEncoding、别混用编码类型 —— Base64 在 Go 里真的不复杂但容易忽略细节。