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

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完全无法读取其值，因此输出为[{},{},{},{}]——即四个空对象。

✅ 正确做法是：

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

1. 将字段名改为导出形式（首字母大写）；
2. 通过json struct tag 显式指定小写/下划线风格的JSON键名，以保持API兼容性和可读性；
3. （可选）为字段添加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:         "652020105829193",             Network:      "20801",             NetworkStatus: "Registered (Roaming)",             SignalQuality: 17,             Slot:         2,             State:        "active",         },         {             IMSI:         "652020105829194",             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":"652020105829193","network":"20801","network_status":"Registered (Roaming)","signal_quality":17,"slot":2,"state":"active"},...] }

⚠️ 注意事项：

• 若字段可能为空值（如””、0、nil），可添加omitempty标签（如json:”imsi,omitempty”）实现在值为零值时省略该字段；
• json tag 中的键名区分大小写，且不支持表达式或变量，必须为静态字符串；
• 类型别名（如type GatewayInfo []SpanInfo）不影响序列化行为，只要元素类型正确即可；
• 始终检查json.Marshal返回的error，避免静默失败（示例中为简洁省略，生产环境务必处理）。

总结：Go的JSON序列化不是“自动魔法”，而是严格依赖导出性 + 结构体标签的显式约定。掌握这一原则，可避免90%以上的空JSON或字段丢失问题。