GolangJSON编码解码入门教程

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《Golang JSON编码解码教程》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

Go语言通过encoding/json包实现JSON编解码，使用json.Marshal将结构体转为JSON，需字段导出并可用json标签自定义键名；json.Unmarshal则解析JSON到变量，需传指针；支持map[string]interface{}处理动态结构，配合omitempty可忽略空值，注意类型断言与时间格式处理。

Go语言通过标准库encoding/json提供对JSON的编码和解码支持，使用简单且高效。处理结构体与JSON之间的转换时，主要依赖json.Marshal和json.Unmarshal两个函数。

基本编码：结构体转JSON

使用json.Marshal可将Go结构体或map转换为JSON格式的字节切片。

package main

import (
    "encoding/json"
    "fmt"
)

type Person struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}

func main() {
    p := Person{Name: "Alice", Age: 30}
    data, err := json.Marshal(p)
    if err != nil {
        fmt.Println("编码失败:", err)
        return
    }
    fmt.Println(string(data)) // 输出: {"name":"Alice","age":30}
}

结构体字段需以大写字母开头（导出），否则无法被序列化。通过json:标签可自定义JSON中的字段名。

基本解码：JSON转结构体

使用json.Unmarshal将JSON数据解析到Go变量中。

func main() {
    jsonData := `{"name":"Bob","age":25}`
    var p Person
    err := json.Unmarshal([]byte(jsonData), &p)
    if err != nil {
        fmt.Println("解码失败:", err)
        return
    }
    fmt.Printf("%+v\n", p) // 输出: {Name:Bob Age:25}
}

目标变量需传入指针，确保数据能写入。若JSON字段在结构体中不存在，会被忽略；若缺少字段，则对应字段保持零值。

处理动态或未知结构

当结构不固定时，可用map[string]interface{}或interface{}接收数据。

func main() {
    jsonData := `{"id":1,"info":{"name":"Tom","active":true}}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonData), &data)

    fmt.Println(data["id"])           // 1
    fmt.Println(data["info"].(map[string]interface{})["name"]) // Tom
}

注意类型断言的使用，避免运行时panic。也可结合json.RawMessage延迟解析部分字段。

常见技巧与注意事项

• 字段标签json:"name,omitempty"表示该字段为空值时不会输出到JSON中，常用于指针、切片、零值字段
• 嵌套结构自动处理，支持数组、切片、指针等类型
• 时间类型需配合time.Time和特定格式标签，如json:"created_at,string"
• 私有字段（小写开头）不会被序列化
• 支持HTML转义控制：json.NewEncoder(os.Stdout).SetEscapeHTML(false)

基本上就这些。掌握Marshal和Unmarshal的使用，加上合理的结构体标签，就能高效处理大多数JSON场景。不复杂但容易忽略细节，比如字段导出和类型匹配问题。

本篇关于《GolangJSON编码解码入门教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！