
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)将正确输出:
立即学习“go语言免费学习笔记(深入)”;
{"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不可见” 这一原则,是避免此类问题的关键。










