Go的encoding/json包仅能反序列化导出字段（即首字母大写的字段），小写字段会被静默忽略，导致解码后结构体字段全为零值且不报错。
go的`encoding/json`包仅能反序列化导出字段（即首字母大写的字段），小写字段会被静默忽略，导致解码后结构体字段全为零值且不报错。
在Go语言中，json.Unmarshal 依赖反射机制访问结构体字段，而Go的反射规则严格遵循包级可见性（exported/unexported）约定：只有首字母大写的字段才是导出字段，才能被外部包（如 encoding/json）读取和设置；以小写字母开头的字段属于包内私有，json 包完全无法访问——即使JSON数据格式正确、字段标签匹配、解析过程无错误，这些字段也始终维持零值（如 0、""、nil），造成“解码成功但内容为空”的典型假象。
以你提供的代码为例：
type Test struct {
id int // ❌ 非导出字段：小写id，json包不可见
text string // ❌ 非导出字段：小写text，json包不可见
}尽管请求体 {"text": "Lorem ipsum dolor sit amet"} 完全合法，且 json.Unmarshal 返回 nil 错误，但 test.id 和 test.text 均未被赋值，最终输出为 {id:0 text:}。
✅ 正确做法是：同时满足两个条件
立即学习“go语言免费学习笔记（深入）”；
Wjs Uploading Video
下载
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 字段名首字母大写（使其导出）；
- 通过 json:"..." 标签显式映射JSON键名（保持API命名风格，如小写 text）。
修正后的结构体如下：
type Test struct {
ID int `json:"id"` // 可选：若JSON中含"id"字段；当前示例无该字段，可省略或保留
Text string `json:"text"` // ✅ 导出字段 + 精确标签映射
}完整可运行的处理器示例（含健壮错误处理）：
func apiAddTestHandler(w http.ResponseWriter, r *http.Request) {
// 读取请求体
body, err := io.ReadAll(r.Body)
if err != nil {
http.Error(w, "Failed to read request body", http.StatusBadRequest)
return
}
defer r.Body.Close()
// 解析JSON
var test Test
if err := json.Unmarshal(body, &test); err != nil {
http.Error(w, "Invalid JSON: "+err.Error(), http.StatusBadRequest)
return
}
// ✅ 此时 test.Text 已正确赋值
fmt.Printf("Received text: %q\n", test.Text) // 输出: "Lorem ipsum dolor sit amet"
// 后续业务逻辑...
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(map[string]string{"status": "success", "received": test.Text})
}⚠️ 注意事项：
- 不要混用大小写风格：Id（驼峰）虽导出，但不符合Go惯用法；推荐 ID（全大写缩写）或 Id（若坚持驼峰需确保一致性），但更推荐标准写法 ID；
- 若JSON字段名含下划线（如 "user_name"），标签必须严格匹配：UserName stringjson:"user_name"`；
- 嵌套结构体同理：所有层级的字段都必须导出，否则嵌套部分将为 nil 或零值；
- json:"-" 可显式忽略字段；json:",omitempty" 可在序列化时跳过零值字段（反序列化不受影响）；
- 永远检查 json.Unmarshal 的返回错误——它不会因字段未导出而报错，但可能因语法错误、类型不匹配等失败。
掌握这一导出规则，是Go中JSON编解码可靠性的基石。记住：不是标签错了，而是字段“看不见”了。
