go结构体字段首字母未大写导致json序列化失败，因go的反射机制仅能访问导出（public）字段，需将字段名首字母大写并配合json标签使用。
在Go语言中，encoding/json包通过反射实现结构体与JSON之间的编组（marshal）和解组（unmarshal）。但反射只能访问导出（exported）字段——即字段名必须以大写字母开头。若字段为小写（如 pods、name），即使添加了 json:"..." 标签，json.Marshal() 仍会忽略该字段，最终生成空对象 {} 或缺失对应键值。
以下为修复前后的关键对比：
❌ 错误示例（字段未导出）：
type PodsCondensed struct {
pods []PodCondensed `json:"pods"` // 小写pods → 非导出字段 → marshal时被忽略
}
type PodCondensed struct {
name string `json:"name"` // 小写name → 同样不可见
colors []string `json:"colors"`
}运行结果：{}（空JSON对象），尽管结构体内数据完整且可正常打印。
立即学习“go语言免费学习笔记（深入）”；
✅ 正确写法（字段首字母大写 + 显式JSON标签）：
type PodsCondensed struct {
Pods []PodCondensed `json:"pods"` // ✅ 导出字段，可被json包访问
}
type PodCondensed struct {
Name string `json:"name"` // ✅ 导出字段
Colors []string `json:"colors"` // ✅ 导出字段
}
// 使用示例
func main() {
fakePods := PodsCondensed{}
fakePod := PodCondensed{
Name: "tier2",
Colors: []string{"blue", "green"},
}
fakePods.Pods = append(fakePods.Pods, fakePod) // 注意：原AddPod方法也需同步更新receiver字段名
data, err := json.Marshal(fakePods)
if err != nil {
log.Fatal(err)
}
fmt.Println(string(data)) // 输出：{"pods":[{"name":"tier2","colors":["blue","green"]}]
}⚠️ 注意事项：
- 方法接收者字段名也需同步更新：若结构体有自定义方法（如 AddPod），其接收者字段引用必须指向导出字段（例如 p.Pods = append(p.Pods, pod)），否则逻辑仍将操作未导出字段；
- json标签不影响可见性：标签仅控制键名映射和序列化行为（如 omitempty），不能绕过导出规则；
- 嵌套结构体同理：所有参与JSON编组的嵌套结构体字段均须导出；
- IDE友好提示：现代Go IDE（如GoLand、VS Code + gopls）通常会对未导出字段在json标签处给出警告，建议开启相关检查。
总结：Go的JSON序列化严格遵循“导出可见性”原则。牢记 “小写=私有=JSON不可见”，养成结构体字段首字母大写的编码习惯，并结合json标签精确控制序列化输出，即可避免此类静默失败问题。
