Golang如何使用encoding/base64进行编码解码

在Golang开发过程中，经常会遇到需要将二进制数据转换为可打印字符串，或者将base64格式的字符串还原为原始数据的场景，这时候就可以使用标准库中的encoding/base64包来完成相关操作。下面我们先来看一张基础流程示意图，帮助理解整体逻辑。

encoding/base64包核心类型和方法

encoding/base64包中提供了两种常用的编码实例，分别对应不同的编码规则：

• StdEncoding：标准base64编码，使用A-Z、a-z、0-9、+、/作为编码字符，末尾用=填充
• URLEncoding：URL安全的base64编码，将标准编码中的+替换为-，/替换为_，适合在URL中传输使用

两种编码实例都提供了以下核心方法：

字符串的base64编码解码示例

最常见的场景是对普通字符串进行编码和解码，下面是标准base64的实现代码：

package main

import (
	"encoding/base64"
	"fmt"
)

func main() {
	// 原始字符串
	originStr := "Golang base64编码解码示例"
	// 标准base64编码
	encodeStr := base64.StdEncoding.EncodeToString([]byte(originStr))
	fmt.Println("编码结果:", encodeStr)

	// 标准base64解码
	decodeBytes, err := base64.StdEncoding.DecodeString(encodeStr)
	if err != nil {
		fmt.Println("解码失败:", err)
		return
	}
	fmt.Println("解码结果:", string(decodeBytes))
}

如果需要使用URL安全的编码，只需要把StdEncoding替换为URLEncoding即可，代码如下：

package main

import (
	"encoding/base64"
	"fmt"
)

func main() {
	originStr := "Golang base64编码解码示例"
	// URL安全base64编码
	urlEncodeStr := base64.URLEncoding.EncodeToString([]byte(originStr))
	fmt.Println("URL安全编码结果:", urlEncodeStr)

	// URL安全base64解码
	decodeBytes, err := base64.URLEncoding.DecodeString(urlEncodeStr)
	if err != nil {
		fmt.Println("解码失败:", err)
		return
	}
	fmt.Println("URL安全解码结果:", string(decodeBytes))
}

字节切片直接编码解码示例

如果不想先转换为字符串，也可以直接对字节切片进行编码解码操作，适合处理二进制数据的场景：

package main

import (
	"encoding/base64"
	"fmt"
)

func main() {
	originData := []byte{0x01, 0x02, 0x03, 0x04, 0x05}
	// 编码目标切片，长度需要符合base64编码规则
	encodeLen := base64.StdEncoding.EncodedLen(len(originData))
	encodeBuf := make([]byte, encodeLen)
	base64.StdEncoding.Encode(encodeBuf, originData)
	fmt.Println("编码后字节切片:", encodeBuf)

	// 解码目标切片
	decodeLen := base64.StdEncoding.DecodedLen(len(encodeBuf))
	decodeBuf := make([]byte, decodeLen)
	n, err := base64.StdEncoding.Decode(decodeBuf, encodeBuf)
	if err != nil {
		fmt.Println("解码失败:", err)
		return
	}
	fmt.Println("解码后字节切片:", decodeBuf[:n])
}

注意事项

在使用encoding/base64包时，有一些细节需要注意：

• 解码时如果传入的字符串不是合法的base64格式，会返回错误，需要做好错误处理
• 标准base64编码后的字符串可能包含+和/，如果放在URL中传输需要先进行URL编码，或者直接使用URLEncoding避免问题
• Encode方法要求目标切片的容量足够，否则会导致数据截断，建议先通过EncodedLen计算所需长度
• Decode方法返回的解码长度是实际有效数据的长度，不要直接使用目标切片的全部长度，避免包含无效的填充数据

总结

Golang的encoding/base64包提供了完善的base64编码解码能力，开发者只需要根据场景选择对应的编码实例，调用对应的方法即可完成操作。无论是处理字符串还是二进制数据，都可以通过包内提供的方法快速实现，同时要注意不同编码格式的差异和错误处理的逻辑，保证代码的健壮性。

Golangencoding_base64base64编码base64解码修改时间：2026-06-02 16:09:07