Go语言encoding/base64包提供标准、安全、高效的Base64编解码能力,非加密而是编码;常用StdEncoding处理一般场景,URLEncoding适配URL/文件名安全需求,需检查解码错误,敏感数据须用AES等真正加密。

Go语言内置的encoding/base64包提供了标准、安全、高效的Base64编解码能力,无需额外依赖。它不叫“加密”,而是编码(Encoding),用于将二进制数据转为可打印ASCII字符串,常用于HTTP传输、URL参数、JSON字段等场景。
Base64编码:把字节切片转成字符串
使用base64.StdEncoding.EncodeToString()最常用,适合一般场景(如HTTP头、日志、配置):
- 输入必须是
[]byte,字符串需先用[]byte(s)转换 - 结果是标准Base64格式(含
+、/和=填充) - 示例:base64.StdEncoding.EncodeToString([]byte("hello")) → "aGVsbG8="
Base64解码:把字符串还原为字节切片
用base64.StdEncoding.DecodeString(),注意它返回([]byte, error),务必检查错误:
- 非法字符(如空格、换行)、长度不对、填充错误都会导致解码失败
- 常见错误:传入URL中未替换的
+//,或缺少填充符= - 示例:data, err := base64.StdEncoding.DecodeString("aGVsbG8=") → 得到
[]byte("hello")
处理URL和文件名安全场景:用URLEncoding
标准Base64的+和/在URL或文件系统中不安全,此时应改用base64.URLEncoding:
立即学习“go语言免费学习笔记(深入)”;
- 用
-代替+,_代替/,省略填充(或按需保留) - 编码:
base64.URLEncoding.EncodeToString([]byte("hi/there"))→ "aGkvdGhlcmU" - 解码:
base64.URLEncoding.DecodeString("aGkvdGhlcmU")自动兼容有无填充
自定义编码字符集(少见但有用)
若需兼容旧系统或特殊协议,可用base64.NewEncoding(string)构造自定义编码器:
- 传入64字符字符串,顺序对应A-Z、a-z、0-9、+、/(标准表)
- 例如:交换最后两字符可生成兼容某嵌入式协议的变体
- 一般项目无需改动,用
StdEncoding或URLEncoding即可
基本上就这些。Base64不是加密,不提供安全性;敏感数据仍需AES等真正加密手段。Go的实现简洁可靠,关键就是选对编码器、记得检查解码错误、URL场景优先用URLEncoding。










