Golang的encoding/json用法结构体标签解析-Golang-PHP中文网

Golang的encoding/json用法结构体标签解析

P粉602998670

发布： 2025-08-28 12:32:01

原创

627人浏览过

正确使用结构体标签可实现Go中JSON的灵活序列化与反序列化。1. 通过json:"name"指定字段映射名；2. omitempty在字段为零值时跳过输出；3. -忽略字段；4. 嵌套结构和指针支持自动解引用与null处理；5. 反序列化需字段可导出，标签匹配JSON键名。

golang的encoding/json用法结构体标签解析

在 Go 语言中，encoding/json 包用于处理 JSON 数据的序列化和反序列化。结构体标签（struct tags）是控制 JSON 编码和解码行为的关键。正确使用结构体标签，可以让结构体字段与 JSON 字段之间建立灵活的映射关系。

基本用法：结构体与 JSON 映射

使用

json:

登录后复制

标签可以指定结构体字段在 JSON 中的键名。默认情况下，字段名会转为小写作为 JSON 键，但通过标签可以自定义。

例如：

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

登录后复制

当该结构体被编码为 JSON 时，输出为：

立即学习“go语言免费学习笔记（深入）”；

{"name":"Alice","age":30}

标签值写在反引号中，

json:"字段名"

登录后复制

指定该字段在 JSON 中的名称。

常用标签选项

结构体标签支持多个选项，用逗号分隔。常见选项包括：

omitempty：当字段为零值时，不输出到 JSON 中
-：忽略该字段，不参与序列化和反序列化
string：将某些类型（如数字、布尔）强制以字符串形式编码

示例：

type Product struct {
    ID       int     `json:"id"`
    Name     string  `json:"product_name"`
    Price    float64 `json:"price,omitempty"`
    IsActive bool    `json:"active,omitempty"`
    Secret   string  `json:"-"`
}

登录后复制

如果

Price

登录后复制

为 0 或

IsActive

登录后复制

为 false，这些字段不会出现在 JSON 输出中。

Secret

登录后复制

字段则完全被忽略。

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

嵌套结构与指针字段处理

结构体可以嵌套，标签规则同样适用。指针字段在编码时会自动解引用，零值指针输出为

null

登录后复制

。

例如：

type Address struct {
    City  string `json:"city"`
    Zip   string `json:"zip_code"`
}

type Person struct {
    Name    string   `json:"name"`
    Addr    *Address `json:"address,omitempty"`
}

登录后复制

如果