根本原因是结构体字段未导出或 JSON key 不匹配且无 json 标签；Go 的 json 包仅处理首字母大写的导出字段，私有字段被静默跳过，不报错也不赋值。
为什么 json.Unmarshal 会静默失败或返回 nil 错误却解析出空值？
根本原因通常是结构体字段未导出（首字母小写），或 JSON key 与字段名不匹配且没加 json 标签。Go 的 encoding/json 只能访问导出字段，私有字段直接跳过，不会报错，也不会填充。
- 确保结构体字段首字母大写（如
Name而非name） - 显式用
json:"name"标签映射小写 JSON key，避免依赖默认驼峰转换（例如user_name→UserName不会自动匹配，必须写json:"user_name"） - 检查嵌套结构体是否也满足导出要求——子字段也要大写
- 别只看
err == nil就认为成功；打印解析后的结构体，确认字段值是否符合预期
如何安全处理 JSON 中可能缺失、null 或类型不一致的字段？
Go 默认把 JSON null 映射为零值（如 0、""、false），无法区分“字段不存在”和“字段为 null”。想精确建模，得用指针或 sql.Null* 类型，但更通用的是自定义类型 + UnmarshalJSON 方法。
- 对可选字段用指针：如
*string、*int64，JSON 中为null或缺失时值为nil - 对数字字段谨慎：JSON
"123"（字符串）和123（数字）默认不兼容，会报json: cannot unmarshal string into Go value；可实现UnmarshalJSON同时支持两种格式 - 避免用
interface{}接收再断言——类型丢失、易 panic；优先定义明确结构体
json.Marshal 输出中文变成 Unicode 转义（\u4f60\u597d）怎么办？
这是默认行为，json.Marshal 为保证 ASCII 安全，会将非 ASCII 字符转义。生产环境 API 返回中文时，用户看到 \u 序列是不可接受的。
- 用
json.MarshalIndent不解决此问题；它只控制缩进，不改变转义策略 - 正确做法是用
json.Encoder并调用其SetEscapeHTML(false)—— 注意：该方法实际也禁用 Unicode 转义 - 更简单直接的方式：用
json.RawMessage包装已处理好的字节，或在Marshal后用bytes.ReplaceAll替换（不推荐，仅临时应急）
encoder := json.NewEncoder(w) encoder.SetEscapeHTML(false) // 关键：禁用 Unicode 和 HTML 转义 encoder.Encode(data)
解析动态 key 名（如时间戳字符串作 map key）该用什么类型？
当 JSON 的 object key 不固定（例如 {"2024-01-01": {...}, "2024-01-02": {...}}），不能硬编码结构体字段。必须用 map[string]T，但要注意 key 类型只能是 string，且需确保 JSON 确实是 object，不是 array。
立即学习“go语言免费学习笔记（深入）”；
- 声明为
map[string]*MyItem，而非map[string]MyItem，避免零值干扰判断 - 反序列化前先用
json.RawMessage暂存，做预检（比如验证 key 是否符合日期格式），再分发解析 - 如果 key 是数字字符串（如
"123"），注意map[string]仍能正常工作；但若期望按数值排序，需额外转换 key 并手动排序 - 性能敏感场景下，大量动态 key 会导致 map 分配开销增大，可考虑用 slice + 查找替代，但牺牲了随机访问便利性
