Go 语言中 JSON 与 Map 相互转换的实现方法

温以宁

发布时间：2026-10-15 | 4人浏览过

原创

在 Go 语言开发中，经常需要在结构化的 Map 数据与 JSON 格式之间进行转换。本文将演示如何使用标准库 encoding/json 中的 Marshal 和 Unmarshal 函数实现这一过程。

核心原理与准备条件

Go 语言处理 JSON 的核心在于 encoding/json 标准库。该库提供了两个关键函数：

Marshal：将 Go 对象（如 map、struct）序列化为 JSON 字节流。
Unmarshal：将 JSON 字节流反序列化为 Go 对象。

使用时的前置条件包括：

导入包：需引入 "encoding/json" 和 "fmt"。
数据类型兼容：json.Marshal 接收 interface{} 类型的对象；json.Unmarshal 接收 JSON 的 []byte 数据和目标对象的指针。
Map 定义：若目标是 Map，建议使用 map[string]interface{} 以支持混合键值类型。

第1步：Map 转换为 JSON

目的：将内存中的 Map 结构序列化为 JSON 格式的字节串。

入口参数：需要转换的任意 Go 对象。
执行动作：调用 json.Marshal。
结果状态：返回 []byte 形式的 JSON 数据和可能的错误信息。

第2步：JSON 还原为 Map

目的：将 JSON 字节流解析并填充到 Map 结构中。

入口参数：JSON 字节流 []byte，以及待填充目标的指针 &targetMap。
重要注意：Unmarshal 的第一个参数必须是 []byte。若原始数据是 String 类型，必须先使用 []byte(str) 进行类型转换。
完成判断：成功时无 error 返回，且目标 Map 已被正确填充。

第3步：完整代码实现与运行

以下代码展示了从创建 Map，到转为 JSON 字符串，再逆向还原为 Map 的完整闭环流程。代码包含基本的错误处理逻辑，确保在实际项目中可复用。

// 当前程序的包名
package main
 
// 导入其它的包
import (
    "encoding/json"
    "fmt"
)
 
func main() {
    // 执行主转换流程
    map2json2map()
}
 
func map2json2map() {
    // 1. 初始化源 Map
    map1 := make(map[string]interface{})
    map1["1"] = "hello"
    map1["2"] = "world"
    
    // 2. Map -> JSON (序列化)
    str, err := json.Marshal(map1)
    if err != nil {
        fmt.Println("Marshal Error:", err)
        return
    }
    fmt.Println("Map to JSON:", string(str))
    
    // 3. JSON -> Map (反序列化)
    // 注意：第二个参数必须传入指针 &map2
    map2 := make(map[string]interface{})
    err = json.Unmarshal(str, &map2)
    if err != nil {
        fmt.Println("Unmarshal Error:", err)
        return
    }
    
    fmt.Println("JSON to Map:", map2)
    fmt.Println("Value of key '1' is:", map2["1"])
}

关键注意事项与排错

指针必要性：在使用 json.Unmarshal 时，如果忘记加取地址符 &（即未传入指针），程序不会报错但会导致 Map 内容无法被更新，这是常见的调试陷阱。
空 Map 处理：Go 中 make(map[string]interface{}) 生成的空 Map 序列化后结果为 {}。若希望输出 null，可使用 nil map，但反序列化时需确保目标容器已初始化。
特殊字符转义：Marshal 默认会对 HTML 敏感字符（如 <, >, &）进行转义。如需关闭此行为，需在 json.Encoder 或自定义 Encoder 中配置。