Go语言中如何让不同变量序列化到同一JSON标签？

原方案不可行的原因 #

你给出的结构体定义里，AgeYears和AgeTimestamp都用了json:"age"标签，标准库encoding/json处理这种重复标签时，只会序列化最后一个带有该标签的字段（也就是AgeTimestamp），没法根据条件动态切换，所以直接用原结构体达不到需求。

可行的实现方法 #

方法1：给结构体自定义JSON序列化逻辑

这是最规范的做法，给foo实现json.Marshaler接口，自己控制序列化过程：

import (
    "encoding/json"
    "fmt"
    "time"
)

type foo struct {
    Name         string        `json:"name"`
    AgeYears     int           `json:"-"` // 用"-"让标准序列化忽略该字段
    AgeTimestamp time.Duration `json:"-"`
}

func (f *foo) MarshalJSON() ([]byte, error) {
    // 定义临时结构，用来生成最终的JSON
    type temp struct {
        Name string      `json:"name"`
        Age  interface{} `json:"age"`
    }

    t := temp{Name: f.Name}
    // 根据字段值判断用哪个作为age
    if f.AgeTimestamp != 0 {
        t.Age = f.AgeTimestamp
    } else {
        t.Age = f.AgeYears
    }

    return json.Marshal(t)
}

使用的时候和你原来的逻辑完全一致：

isTimestamp := true
var res *foo
if isTimestamp {
    res = &foo{
        Name:         "Per",
        AgeTimestamp: 1342342554,
    }
} else {
    res = &foo{
        Name:     "Per",
        AgeYears: 30,
    }
}

data, _ := json.MarshalIndent(res, "", "    ")
fmt.Println(string(data))

方法2：直接返回动态Map或临时结构体

如果不想给结构体绑定固定的序列化逻辑，可以直接在返回时构建动态的map，跳过结构体的限制：

import (
    "encoding/json"
    "fmt"
    "time"
)

func getFoo(isTimestamp bool) interface{} {
    if isTimestamp {
        return map[string]interface{}{
            "name": "Per",
            "age":  time.Duration(1342342554),
        }
    }
    return map[string]interface{}{
        "name": "Per",
        "age":  30,
    }
}

// 调用示例
data, _ := json.MarshalIndent(getFoo(true), "", "    ")
fmt.Println(string(data))

这种方式更灵活，但缺点是失去了Go结构体的类型检查，适合简单场景。

方法3：利用指针和omitempty标签

把两个年龄字段改成指针类型，配合omitempty标签，让标准库只序列化非空指针的字段：

import (
    "encoding/json"
    "fmt"
    "time"
)

type foo struct {
    Name         string         `json:"name"`
    AgeYears     *int           `json:"age,omitempty"`
    AgeTimestamp *time.Duration `json:"age,omitempty"`
}

// 使用示例
isTimestamp := true
var res *foo
if isTimestamp {
    ts := time.Duration(1342342554)
    res = &foo{
        Name:         "Per",
        AgeTimestamp: &ts,
    }
} else {
    age := 30
    res = &foo{
        Name:     "Per",
        AgeYears: &age,
    }
}

data, _ := json.MarshalIndent(res, "", "    ")
fmt.Println(string(data))

注意：必须保证同一时间只给其中一个字段赋值（另一个保持nil），如果两个指针都不为nil，标准库还是会序列化最后一个字段，导致结果不符合预期。

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