Go语言中JSON反序列化为何要求结构体字段首字母大写？-Golang-PHP中文网

Go语言中JSON反序列化为何要求结构体字段首字母大写？

go语言的json.unmarshal函数只能对导出（即首字母大写的）结构体字段进行反序列化，小写字母开头的字段因不可导出而被忽略，始终保持零值。

go语言的json.unmarshal函数只能对导出（即首字母大写的）结构体字段进行反序列化，小写字母开头的字段因不可导出而被忽略，始终保持零值。

在Go中，结构体字段的可见性（exported/unexported） 由其名称首字母决定：首字母为大写（如 Name, Score）表示该字段是导出的（exported），可在包外访问；首字母为小写（如 name, score）则为未导出的（unexported），仅限当前包内使用。

encoding/json 包在执行 json.Unmarshal 时，严格遵循 Go 的反射规则——它仅能读取和设置导出字段。这是因为 json 包无法通过反射修改未导出字段（即使同包内也不行），这是 Go 语言安全模型的设计约束，而非实现缺陷。

以下示例清晰展示了这一行为：

Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载

package main

import (
    "encoding/json"
    "fmt"
)

type GameOne struct {
    Name  string `json:"name"`
    Score int    `json:"score"`
}

type GameTwo struct {
    name  string `json:"name"` // ❌ 未导出，反序列化时被跳过
    score int    `json:"score"` // ❌ 同样被跳过
}

func main() {
    data := []byte(`{"name":"Chess","score":100}`)

    var g1 GameOne
    json.Unmarshal(data, &g1)
    fmt.Printf("GameOne: %+v\n", g1) // 输出：{Name:"Chess" Score:100}

    var g2 GameTwo
    json.Unmarshal(data, &g2)
    fmt.Printf("GameTwo: %+v\n", g2) // 输出：{name:"" score:0} —— 字段保持零值
}

⚠️ 注意事项：