go 的 encoding/json 包仅能访问导出（首字母大写）的结构体字段，若字段为小写私有字段，则反序列化失败导致值为空。解决方法是将字段名首字母大写，并可选使用 json 标签映射大小写不一致的 json 键名。
go 的 encoding/json 包仅能访问导出（首字母大写）的结构体字段，若字段为小写私有字段，则反序列化失败导致值为空。解决方法是将字段名首字母大写，并可选使用 json 标签映射大小写不一致的 json 键名。
在 Go 中使用 json.Unmarshal 解析 JSON 数据时，一个高频且隐蔽的错误是：结构体字段始终为空（零值），即使 JSON 数据格式正确、无语法错误。根本原因在于 Go 的反射机制与包可见性规则——encoding/json 依赖反射读写结构体字段，而只有导出字段（即首字母大写的字段）才能被外部包访问；小写开头的字段属于包级私有，json 包无法读取或赋值，因此反序列化后字段保持默认零值（如空字符串 ""、0、nil 等）。
以下为修复后的完整示例代码：
package main
import (
"encoding/json"
"fmt"
)
func main() {
var jsonBlob = []byte(`[
{"name": "Platypus", "spec": "Monotremata", "id": 25},
{"name": "Quoll", "spec": "Dasyuromorphia", "id": 25}
]`)
// ✅ 正确：字段首字母大写，成为导出字段
type Animal struct {
Name string `json:"name"` // 显式声明 JSON key，增强可读性与健壮性
Spec string `json:"spec"`
Id uint32 `json:"id"`
}
var animals []Animal
err := json.Unmarshal(jsonBlob, &animals)
if err != nil {
fmt.Fatalf("JSON unmarshal failed: %v", err)
}
fmt.Printf("%+v\n", animals)
// 输出：[{Name:"Platypus" Spec:"Monotremata" Id:25} {Name:"Quoll" Spec:"Dasyuromorphia" Id:25}]
}
? 关键要点：
- 导出是前提：Name、Spec、Id 必须大写，否则 json 包完全忽略这些字段；
- 标签非必需但强烈推荐：虽然 Go 的 json 包具备“智能匹配”能力（如自动将 Name 与 "name" 关联），但该行为依赖字段名的大小写折叠规则（case-insensitive matching），并非严格保证。显式使用 `json:"name"` 标签可明确语义、避免歧义，并支持更灵活的映射（如字段重命名、忽略字段、嵌套结构等）；
- 标签进阶用法示例：
type Animal struct { Name string `json:"name,omitempty"` // 空值时省略该字段 Alias string `json:"-"` // 完全忽略（不参与序列化/反序列化） Weight float64 `json:"weight_in_kg"` }
⚠️ 注意事项：
- 不要误以为 json 包会通过反射“绕过” Go 的可见性规则——这是语言设计的硬性限制，与 json 包实现无关；
- 若需保留小写字段名（如出于业务建模习惯），应通过组合方式封装导出字段，而非直接暴露小写字段；
- 在调试时，可使用 fmt.Printf("%#v", animals) 或检查 err 值（虽然本例中 err 为 nil，因解析本身成功，只是字段未被设置）。
总结：Go 的 JSON 处理遵循“导出即可见”原则。确保结构体字段导出是反序列化的第一步，再辅以清晰的 json 标签，即可写出健壮、可维护的 JSON 交互代码。
