使用 json:"-" 标签可完全忽略结构体字段的 json 反序列化,支持单独使用、与其他标签组合、嵌套结构体中局部忽略,也可通过空接口或自定义 unmarshaljson 方法实现动态控制。

在使用 Go 语言进行 JSON 反序列化时,若希望某个结构体字段不参与解析过程,则可通过结构体标签中的 json:"-" 显式声明忽略。以下是实现该目标的多种方式:
一、使用 json:"-" 标签完全忽略字段
该标签指示 encoding/json 包在反序列化过程中跳过该字段,无论 JSON 数据中是否存在对应键,均不赋值也不报错。
1、定义结构体,在目标字段后添加 json:"-" 标签。
2、调用 json.Unmarshal 函数将 JSON 字节流解析到该结构体实例。
3、检查结构体字段值,确认被标记字段未被修改(保持零值)。
二、结合其他标签组合使用
json:"-" 可与其他结构体标签共存,例如与自定义字段名、omitempty 等标签配合,但需注意其优先级最高——一旦指定为 "-",其余行为均失效。
1、编写结构体字段,格式如 Name string `json:"name,omitempty" db:"name"`。
2、将其中某字段改为 Secret string `json:"-" db:"secret"`。
3、执行 Unmarshal 后验证 Secret 字段仍为 ""(字符串零值)。
三、嵌套结构体中忽略特定子字段
当结构体包含匿名或命名嵌套字段时,可在嵌套类型内部单独标注 json:"-",仅影响该层级字段,不影响外层或其他嵌套成员。
1、定义外层结构体,并嵌入一个内嵌结构体类型。
2、在内嵌结构体中对需忽略的字段添加 json:"-"。
3、传入含对应键的 JSON 数据,反序列化后检查嵌套字段是否保持零值。
四、通过空接口临时绕过字段映射
不修改结构体定义的前提下,可先将 JSON 解析为 map[string]interface{} 或 interface{},再手动提取所需字段并忽略目标键,适用于动态字段场景。
1、调用 json.Unmarshal 将原始字节解析为 map[string]interface{} 类型变量。
2、使用 delete() 函数移除键名为待忽略字段名的条目。
3、将处理后的 map 再次 Marshal 并 Unmarshal 到目标结构体。
五、自定义 UnmarshalJSON 方法实现细粒度控制
为结构体实现 UnmarshalJSON 方法,可在解析过程中主动跳过特定字段名,支持运行时逻辑判断,灵活性高于静态标签。
1、为结构体定义接收者方法 func (s *MyStruct) UnmarshalJSON(data []byte) error。
2、在方法内调用 json.Unmarshal 解析为 map[string]json.RawMessage。
3、遍历该 map,对键名为需忽略字段的项直接跳过,其余调用 json.Unmarshal 赋值到对应字段。










