Go语言中嵌套结构体JSON序列化失败的解决方案

go的json.marshal函数只能序列化导出（首字母大写）的结构体字段，小写字段默认不可见，导致输出空对象{}，需将字段名首字母大写或自定义marshaljson方法。

在Go语言中，encoding/json包对结构体进行JSON序列化时遵循严格的可见性规则：只有首字母大写的导出字段（exported fields）才能被外部包（如json）访问并序列化；而小写字母开头的字段属于未导出（unexported）成员，在json.Marshal调用时会被忽略，最终生成空JSON对象（如{}）。

以原代码为例，Configitem和GuiConfig的所有字段均为小写（如local_address、configs），因此json.Marshal(config1)返回{}——并非程序崩溃，而是“静默跳过”所有字段。

✅ 正确做法是将结构体字段改为导出形式（首字母大写），并可配合json标签明确字段名，提升可读性与兼容性：

type Configitem struct {
    LocalAddress string `json:"local_address"`
    LocalPort    int    `json:"local_port"`
    Method       string `json:"method"`
    Password     string `json:"password"`
    Server       string `json:"server"`
    ServerPort   string `json:"server_port"`
    Timeout      int    `json:"timeout"`
}

type GuiConfig struct {
    Configs []*Configitem `json:"configs"`
    Index   int           `json:"index"`
}

修改后，json.Marshal(config1)将正确输出：

{"configs":[{"local_address":"eouoeu","local_port":111,"method":"eoeoue","password":"ouoeu","server":"oeuoeu","server_port":"qoeueo","timeout":3333}],"index":1}

⚠️ 注意事项：

• 即使添加了json标签，字段仍必须导出（大写首字母），否则标签无效；
• 若因封装需求必须保留字段私有（如避免外部直接修改），可为结构体实现json.Marshaler接口，自定义序列化逻辑；
• 建议始终为导出字段添加json标签，显式控制JSON键名，避免结构体字段名变更影响API兼容性。

总结：Go的JSON序列化不是“反射所有字段”，而是“仅反射导出字段”。牢记 “小写=私有=JSON不可见” 这一原则，是避免此类问题的关键。