Golang序列化结构体时能否跳过指定json标签？如何实现？

结论 #

该需求完全可实现，针对你给出的嵌套层级冗余的场景，最常用的是json:",inline"内联标签方案，也可根据业务复杂度选择自定义序列化方法、中间态map处理两种方案。

方案1：使用json:",inline"内联标签（推荐，适配你的场景） #

Golang标准库的json包支持inline标签，作用是将被标记的结构体字段的所有子字段，直接提升到父结构体的JSON输出层级，不会生成该字段本身的JSON键。

错误的原结构体定义（会生成多余Interface层级） #

type Interface struct {
    Name    string `json:"Name"`
    Address string `json:"Address"`
}

type Employee struct {
    // 这里指定了json键为Interface，序列化后会生成多余层级
    Interface Interface `json:"Interface"`
}

type Root struct {
    Employee Employee `json:"Employee"`
}

上述结构体序列化后输出为你得到的结果：{"Employee":{"Interface":{"Name":"xyz", "Address":"abc"}}}

修改后的结构体定义 #

type Interface struct {
    Name    string `json:"Name"`
    Address string `json:"Address"`
}

type Employee struct {
    // 用inline标签，不指定json键，直接内联子字段
    Interface Interface `json:",inline"`
}

type Root struct {
    Employee Employee `json:"Employee"`
}

测试代码 #

func main() {
    data := Root{
        Employee: Employee{
            Interface: Interface{
                Name:    "xyz",
                Address: "abc",
            },
        },
    }
    res, _ := json.Marshal(data)
    fmt.Println(string(res))
}

输出结果就是你期望的格式：{"Employee":{"Name":"xyz", "Address":"abc"}}

注意：json:",inline"标签仅支持结构体类型的字段，若字段为结构体指针类型，需确保指针非空才会输出内联字段。

方案2：自定义MarshalJSON方法（适用于复杂过滤逻辑） #

如果你的场景不止是跳过层级，还要做其他字段过滤规则，或者不能修改原有结构体标签，可以给对应结构体实现json.Marshaler接口，自定义序列化逻辑：

// 给Employee结构体实现MarshalJSON方法
func (e Employee) MarshalJSON() ([]byte, error) {
    // 直接返回内嵌Interface的序列化结果，跳过Interface层级
    return json.Marshal(e.Interface)
}

方案3：中间态map转换（适用于临时处理、不想改结构体的场景） #

如果是已经序列化得到了冗余的JSON字符串，可以先反序列化为map[string]interface{}，手动调整层级后再序列化：

func main() {
    // 原冗余JSON
    rawJson := []byte(`{"Employee":{"Interface":{"Name":"xyz", "Address":"abc"}}}`)
    var temp map[string]interface{}
    _ = json.Unmarshal(rawJson, &temp)
    
    // 提取Interface层级内容，替换Employee的值
    employee := temp["Employee"].(map[string]interface{})
    temp["Employee"] = employee["Interface"]
    
    // 重新序列化
    res, _ := json.Marshal(temp)
    fmt.Println(string(res))
}

输出结果和期望格式一致。

内容的提问来源于stack exchange，提问作者bisma