Go 的 json.Unmarshal 要求结构体字段必须是导出（首字母大写）且有对应 JSON 标签，否则会静默忽略字段，导致解码后字段为 nil。
go 的 `json.unmarshal` 要求结构体字段必须是导出（首字母大写）且有对应 json 标签，否则会静默忽略字段，导致解码后字段为 nil。
在 Go 中解析嵌套 JSON 时，若使用自定义结构体却始终得到 nil 值（无错误但数据未填充），最常见的根本原因是：结构体字段未导出。
Go 的 encoding/json 包仅能访问并序列化/反序列化导出字段（即首字母大写的字段）。而问题中定义的结构体使用了小写字段名：
type GameState struct {
missiles []*Missile // ❌ 非导出字段：无法被 json 包访问
others []*Player // ❌ 同上
you *Player // ❌ 同上
}
type Message struct {
gamestate *GameState // ❌
messagetype string // ❌
}
由于所有字段均为小写，json.Unmarshal 完全无法写入这些字段，因此 gamestate、missiles 等保持为 nil，且不返回错误（这是设计行为：忽略不可访问字段）。
✅ 正确做法是将字段改为导出，并推荐显式添加 json 标签以明确映射关系：
type GameState struct {
Missiles []*Missile `json:"missiles"`
Others []*Player `json:"others"`
You *Player `json:"you"`
}
type Message struct {
GameState *GameState `json:"gamestate"`
MessageType string `json:"messagetype"`
}
注意：
- 字段名首字母必须大写（如 Missiles），否则仍不可导出；
- json 标签中的键名应与 JSON 实际字段名一致（如 "missiles" 对应 JSON 中的 "missiles"）；
- 若 JSON 字段名含下划线（如 "message_type"），可通过标签映射：MessageType stringjson:"message_type"`；
- 所有嵌套结构体（如 Missile、Player）也需遵循相同规则——字段导出 + 正确标签。
此外，建议在解码后做非空校验，避免因字段缺失导致 panic：
var msg Message
if err := json.Unmarshal(data, &msg); err != nil {
log.Fatal("JSON decode failed:", err)
}
if msg.GameState == nil {
log.Fatal("gamestate is missing or invalid")
}
总结：Go 的 JSON 解析不是“弱类型自动适配”，而是严格依赖导出性与结构体契约。牢记 “小写 = 私有 = JSON 不可见”，即可规避 90% 的静默解码失败问题。
