Go语言中JSON序列化：结构体字段导出与标签配置详解

花韻仙語 2026-01-18 00:00:00 次阅读

go语言的json.marshal函数仅能序列化导出（首字母大写）的结构体字段，未导出字段会被忽略；同时需合理使用struct tag指定json键名，否则默认使用大写驼峰名，影响api兼容性。

在Go中进行JSON序列化时，一个常见却容易被忽视的关键规则是：只有导出（exported）字段才能被encoding/json包访问和编码。所谓“导出字段”，即字段名以大写字母开头（如IMSI），而非小写（如imsi）。这是因为Go的反射机制无法访问非导出字段——而json.Marshal正是基于反射实现的。

在你的原始代码中：

type SpanInfo struct {
    imsi string          // ❌ 非导出字段 → JSON中被忽略
    network string       // ❌ 同上
    network_status string // ❌ 字段名本身也不符合Go命名规范（含下划线）
    signal_quality int    // ❌
    slot int              // ❌
    state string          // ❌
}

所有字段均为小写开头，属于包级私有字段，json.Marshal完全无法读取其值，因此输出为[{},{},{},{}]——即四个空对象。

✅ 正确做法是：

将字段名改为导出形式（首字母大写）；
通过json struct tag 显式指定小写/下划线风格的JSON键名，以保持API兼容性和可读性；
（可选）为字段添加omitempty等修饰符增强灵活性。

修正后的结构体定义如下：

type SpanInfo struct {
    IMSI         string `json:"imsi"`
    Network      string `json:"network"`
    NetworkStatus string `json:"network_status"`
    SignalQuality int   `json:"signal_quality"`
    Slot         int    `json:"slot"`
    State        string `json:"state"`
}

type GatewayInfo []SpanInfo

完整使用示例：

func getGatewayInfo(spans []SpanInfo) GatewayInfo {
    return GatewayInfo(spans)
}

func main() {
    spans := []SpanInfo{
        {
            IMSI:         "652025105829193",
            Network:      "20801",
            NetworkStatus: "Registered (Roaming)",
            SignalQuality: 17,
            Slot:         2,
            State:        "active",
        },
        {
            IMSI:         "652025105829194",
            Network:      "20801",
            NetworkStatus: "Registered (Roaming)",
            SignalQuality: 16,
            Slot:         3,
            State:        "standby",
        },
    }

    gatewayInfo := getGatewayInfo(spans)
    jsonInfo, err := json.Marshal(gatewayInfo)
    if err != nil {
        log.Fatal("JSON marshal error:", err)
    }

    log.Printf("JSON output: %s", jsonInfo)
    // 输出示例：
    // [{"imsi":"652025105829193","network":"20801","network_status":"Registered (Roaming)","signal_quality":17,"slot":2,"state":"active"},...]
}

⚠️ 注意事项：