go语言的json包只能解析结构体中首字母大写的导出字段，小写字段无法被自动填充，这是导致json解码后对象为空的最常见原因。
在Go语言中，encoding/json 包遵循严格的可见性规则：只有导出（exported）字段——即首字母大写的字段——才能被 JSON 反序列化（json.Unmarshal 或 json.NewDecoder.Decode）读取和赋值。若结构体字段为小写（如 id, refresh_token），它们属于未导出字段（unexported），即使存在正确的 JSON tag，json 包也无法访问或设置其值，最终导致解码成功但结构体字段仍为空字符串（或其他零值），且不报错。
以下是一个修正前后的对比示例：
❌ 错误写法（字段未导出，解码无效）：
type RefreshTokenData struct {
id string `json:"id"` // 小写 → 未导出 → 被忽略
refresh_token string `json:"refresh_token"` // 同样被忽略
// ... 其他小写字段
}✅ 正确写法（首字母大写 + 显式 JSON tag）：
立即学习“go语言免费学习笔记（深入）”；
type RefreshTokenData struct {
Id string `json:"id"`
IssuedAt string `json:"issued_at"` // 注意：tag 保持小写，字段名大写
Scope string `json:"scope"`
InstanceURL string `json:"instance_url"`
TokenType string `json:"token_type"`
RefreshToken string `json:"refresh_token"`
IDToken string `json:"id_token"` // 注意：原始JSON含"id_token"，需映射
Signature string `json:"signature"`
AccessToken string `json:"access_token"`
}? 关键要点：
- 字段名必须以大写字母开头（如 RefreshToken），才能被 json 包访问；
- JSON tag（如 `json:"refresh_token"`）用于指定该字段对应 JSON 中的键名，大小写与 JSON 原文严格匹配；
- 原始 JSON 中存在 "id_token" 字段，但原结构体未定义对应字段，会导致该值丢失——务必确保结构体字段与 JSON 键一一覆盖（或使用 map[string]interface{} 动态处理未知字段）；
- 解码错误检查不可省略，但本例中因无语法错误，err == nil 容易造成“解码成功”的假象，实则数据未填充。
? 最佳实践建议：
- 使用工具辅助生成结构体：如 json-to-go 或 VS Code 插件，可自动生成符合 Go 导出规范的结构体；
- 对 OAuth 等标准响应，优先参考官方 SDK 或成熟库（如 golang.org/x/oauth2）的结构定义；
- 开发阶段可添加日志验证解码结果：
fmt.Printf("Decoded: %+v\n", tokenData) // 查看实际填充内容
遵循导出字段原则，是 Go 中 JSON 处理的基石。一次首字母修正，即可解决 90% 的“解码无反应”问题。
