本文详解go语言中使用json.marshal和json.unmarshal时，为何从map反序列化到结构体后字段仍为零值——根本原因在于结构体字段未导出，导致json包无法访问这些非导出字段。
本文详解go语言中使用json.marshal和json.unmarshal时，为何从map反序列化到结构体后字段仍为零值——根本原因在于结构体字段未导出，导致json包无法访问这些非导出字段。
在Go语言中，encoding/json 包遵循严格的可见性规则：只有首字母大写的导出字段（exported fields）才能被JSON编解码器读写。而原代码中 PDPOffer 结构体的所有字段均以小写字母开头（如 cart_value、discount_amount_default、max_discount），属于非导出字段（unexported），因此 json.Unmarshal 在解析时完全忽略它们，仅初始化结构体的零值（如 int 为 0，string 为空字符串），最终输出 &{cart_value:0 discount_amount_default:0 max_discount:""}。
✅ 正确写法：将字段首字母大写，并保持 JSON tag 映射
type PDPOffer struct {
CartValue int `json:"cart_value"`
DiscountAmountDefault int `json:"discount_amount_default"`
MaxDiscount string `json:"max_discount"`
}
注意：
- 字段名（如 CartValue）必须导出（大写开头）；
- json tag 用于指定JSON键名，与字段名无关，仍可保留下划线风格以匹配API约定；
- tag 中的键名需与 map 中的 key 完全一致（区分大小写、拼写、空格）。
✅ 完整修复示例
package main
import (
"encoding/json"
"fmt"
)
func main() {
type PDPOffer struct {
CartValue int `json:"cart_value"`
DiscountAmountDefault int `json:"discount_amount_default"`
MaxDiscount string `json:"max_discount"`
}
a := map[string]interface{}{
"cart_value": 1,
"discount_amount_default": 50,
"max_discount": "20%",
}
data, err := json.Marshal(a)
if err != nil {
panic(err)
}
var pdf PDPOffer
if err := json.Unmarshal(data, &pdf); err != nil {
panic(err)
}
fmt.Printf("%+v\n", pdf) // 输出：{CartValue:1 DiscountAmountDefault:50 MaxDiscount:"20%"}
}
⚠️ 注意事项
- 即使 json tag 存在，若字段未导出，tag 也完全无效；
- map[string]interface{} 本身无需导出，因它是内置类型且 json.Marshal 可直接处理；
- 若需兼容旧有命名习惯，可借助工具（如 gofmt 或 IDE）批量重命名字段，或使用 github.com/mitchellh/mapstructure 等第三方库实现更灵活的 map→struct 转换（支持非导出字段+自定义解码逻辑）；
- 建议始终为结构体字段添加明确的 JSON tag，避免依赖默认字段名映射（Go 默认将 FieldName 映射为 "field_name"，但该行为不可靠且不推荐依赖）。
导出是Go反射机制与标准库协作的基础前提——理解并遵守这一规则，是写出健壮JSON处理代码的关键第一步。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
