json.unmarshal内部已封装反射逻辑，用户只需确保传入地址、字段导出、标签正确；仅在动态字段名或未知结构等特殊场景才需手写反射干预。
Go 的 json 包本身不依赖反射做常规解析，但反射是其实现底层字段查找和值设置的核心机制；你不需要手动用 reflect 去“实现 JSON 解析”，而是该理解 json.Unmarshal 如何利用反射，以及你在什么场景下才真得动用反射来干预这个过程。
为什么直接用 json.Unmarshal 时几乎不用写反射代码
json.Unmarshal 内部已完整封装了反射逻辑：它会递归检查结构体字段的可见性、标签（json:"name"）、类型兼容性，并调用 reflect.Value.Set() 完成赋值。你只需确保：
- 目标变量是地址（
&v），否则反射无法写入 - 结构体字段首字母大写（导出），否则反射不可见
- 字段标签拼写正确，比如
json:"user_id,string"中的string修饰符仅对数字/布尔类型生效 - 嵌套结构体字段也需导出，否则深层字段会被静默忽略
需要手写反射的典型场景：动态字段名或未知结构
当 JSON 键名在运行时才确定（如 Webhook 携带任意 custom_fields 对象），或你接收的是混合类型 map（map[string]interface{}）但想映射到具体结构体字段时，才需介入反射。例如：
// 已知字段名存在，但不确定是否在 struct 中
func setFieldByJSONKey(v interface{}, key string, val interface{}) error {
rv := reflect.ValueOf(v)
if rv.Kind() != reflect.Ptr || rv.IsNil() {
return fmt.Errorf("must pass non-nil pointer")
}
rv = rv.Elem()
if rv.Kind() != reflect.Struct {
return fmt.Errorf("not a struct")
}
// 查找 tag 为 key 的字段
for i := 0; i < rv.NumField(); i++ {
f := rv.Type().Field(i)
if tag := f.Tag.Get("json"); tag != "" {
jsonName := strings.Split(tag, ",")[0]
if jsonName == key {
fv := rv.Field(i)
if fv.CanSet() {
fv.Set(reflect.ValueOf(val))
}
return nil
}
}
}
return fmt.Errorf("no field with json tag %q", key)
}
注意：这里没处理类型转换（比如把 string 转 int），实际中需用 strconv 或第三方库补充。
立即学习“go语言免费学习笔记（深入）”；
json.RawMessage 是比裸反射更安全的“延迟解析”手段
当你只想暂存某段 JSON 不立即解析（比如字段类型待后续判断），优先用 json.RawMessage，而不是先解析成 interface{} 再用反射拆解：
type Event struct {
ID int
Type string
Data json.RawMessage // 不解析，保留原始字节
}
var e Event
json.Unmarshal(b, &e)
// 后续按 e.Type 决定用哪个 struct 解析 e.Data
if e.Type == "payment" {
var p Payment
json.Unmarshal(e.Data, &p) // 二次解析，无反射负担
}
这比用反射遍历 map[string]interface{} 手动匹配字段更清晰、性能更好，也规避了反射对非导出字段、空接口等的处理陷阱。
容易被忽略的反射边界：私有字段、嵌套指针与零值
即使你写了反射逻辑，以下情况仍会失败或静默跳过：
- 结构体字段是私有的（小写开头），
reflect.Value.CanSet()返回 false，且FieldByName查不到 - 字段是
*string类型但值为nil，反射无法直接.SetString()，需先.Set(reflect.New()) - JSON 中字段为
null，而目标字段是非指针类型（如string），json.Unmarshal会设为空字符串而非报错——反射层面无法区分这是“没传”还是“传了 null” -
json:",omitempty"标签只影响序列化，不影响反序列化行为，别指望它让反射跳过字段
真正要靠反射定制解析逻辑时，往往意味着你已脱离标准流程，此时务必测试 null、空字符串、类型错位等边界输入，不能只看 happy path。
