最直接安全的Base64编码方式是base64.StdEncoding.EncodeToString()，它将[]byte转为标准Base64字符串（含+/=）；解码需处理*base64.CorruptInputError，URL安全场景应使用URLEncoding或RawURLEncoding。
Go 里用 encoding/base64 编码字节切片最直接的方式
直接调用 base64.StdEncoding.EncodeToString() 是最常用、最安全的编码入口，它把 []byte 转成标准 Base64 字符串（含 +、/、=）。
- 别用
Encode()直接写到[]byte—— 容易忽略目标缓冲区长度，导致 panic 或截断 - 如果要编码字符串，先用
[]byte("hello")转换，Base64 操作的是字节，不是字符串本身 - 标准编码（
StdEncoding）适合 HTTP/JSON 场景；URL 安全场景改用URLEncoding（替换+//为-/_，省略=）
package mainimport ( "encoding/base64" "fmt" )
func main() { data := []byte("hello world") encoded := base64.StdEncoding.EncodeToString(data) fmt.Println(encoded) // aGVsbG8gd29ybGQ= }
解码时必须处理 base64.CorruptInputError
解码失败几乎总是因为输入非法：长度不对（非 4 的倍数）、含非法字符、填充过多。错误类型是 base64.CorruptInputError，不是通用 error 字符串匹配。
- 永远用
if err != nil判断，不要靠strings.Contains(err.Error(), "illegal") - 如果输入来自用户或网络，提前用
base64.StdEncoding.WithPadding(base64.NoPadding)可跳过填充校验（但仅限你确定输入无填充时） - URL 安全编码的字符串不能用
StdEncoding.DecodeString()直接解，会报illegal base64 data—— 必须用URLEncoding
decoded, err := base64.StdEncoding.DecodeString("aGVsbG8gd29ybGQ=")
if err != nil {
// err 是 *base64.CorruptInputError 类型
panic(err)
}
fmt.Printf("%s\n", decoded) // hello world
RawStdEncoding 和 URLEncoding 的实际区别在哪
三者核心差异在字符集和填充规则，选错就解不出：
-
StdEncoding：字符集A-Z a-z 0-9 + /，末尾补=对齐到 4 字节倍数 -
RawStdEncoding：同字符集，但不加填充（即去掉所有=），适合固定长度二进制协议 -
URLEncoding：字符集A-Z a-z 0-9 - _，也默认加填充；RawURLEncoding才是无填充 + URL 安全字符
例如 JWT 的 payload 部分通常用 RawURLEncoding —— 无 =、无 +//，能直接塞进 URL path 或 query。
立即学习“go语言免费学习笔记（深入）”；
性能敏感时注意 EncodeToString 的内存分配
EncodeToString() 内部会新建 string，对高频小数据（如日志 ID 编码）有 GC 压力。可复用 bytes.Buffer 或预分配 []byte 缓冲区。
- 编码前算长度：
base64.StdEncoding.EncodedLen(len(src))得到结果字节数 - 然后用
base64.StdEncoding.Encode(dst, src)写入预分配的dst []byte，再转string(dst)避免额外拷贝 - 注意：
dst长度必须 ≥EncodedLen()，否则 panic
真正复杂的不是 API 本身，而是搞清你要对接的系统用的是哪套变种 —— 看文档、抓真实请求、比对第一个字符，比硬背规则管用。
