如何将结构体快速转换为 map[string]interface{}？

structs.ToMap 是最省事的选择，但得看你的场景是否允许类型丢失和依赖引入。

先抛个结论：如果有现成的好轮子，谁愿意自己造？structs.ToMap 确实一行代码就能搞定，但这里面的坑，踩过的人才知道。

用 structs.ToMap 一行搞定，但注意字段标签和嵌套行为

如果你不介意引入一个轻量第三方库，github.com/fatih/structs 的 ToMap 函数确实能一行完成转换，而且它默认读取的是 structs 标签，不是咱们常用的 json 标签——这个区别特别容易翻车：

type User struct {
    Name string `structs:"name"`
    Age  int    `structs:"age"`
}
u := User{Name: "Alice", Age: 30}
m := structs.ToMap(u) // map[string]interface{}{"name":"Alice", "age":30}

几个常见大坑：

• 没加 structs 标签时，它会 fallback 到字段名（大写首字母），比如 Name 变成 "Name"，而不是你想要的 "name"
• 嵌套结构体自动转成 map[string]interface{}，但不会递归处理指针或 interface{} 字段
• 不支持 omitempty 逻辑——空字符串、0、nil 都照常塞进 map，一个不落

用 json.Marshal + json.Unmarshal 最通用，但数字类型全变 float64

这是零依赖方案里最常用的做法，适合 API 响应、日志打点等对底层类型不敏感的场景：

b, _ := json.Marshal(&u)
var m map[string]interface{}
json.Unmarshal(b, &m)

关键问题就一个：int、uint、int64 等整型字段反序列化后全部变成 float64。这意味着：

• m["age"] 的类型是 float64，哪怕原始字段是 int
• 如果后续要传给需要精确整型的函数（比如数据库驱动、gRPC message），必须手动类型断言或转换
• time.Time、sql.NullString 这类自定义类型需提前实现 MarshalJSON，否则直接 panic

手写反射版可控性最强，但得自己处理指针、嵌套和空值

当你要保留原始字段类型、跳过私有字段、或按 json 标签映射 key 名时，反射是唯一靠谱路径：

func ToMap(in interface{}, tag string) (map[string]interface{}, error) {
    v := reflect.ValueOf(in)
    if v.Kind() == reflect.Ptr { v = v.Elem() }
    if v.Kind() != reflect.Struct { return nil, fmt.Errorf("not struct") }
    t := v.Type()
    out := make(map[string]interface{})
    for i := 0; i < v.NumField(); i++ {
        field := t.Field(i)
        value := v.Field(i)
        if !value.CanInterface() { continue } // 跳过私有字段
        tagName := field.Tag.Get(tag)
        if tagName == "" || tagName == "-" { continue }
        out[tagName] = value.Interface()
    }
    return out, nil
}

使用时注意：

• 必须传入结构体实例或指针，不能传 interface{} 包装过的值
• 嵌套结构体字段默认原样塞进去（仍是 struct 类型），如需深度展开得递归调用
• 空值（""、0、nil）不会自动过滤，要加 omitempty 逻辑得自己判断 value.IsZero()

别忽略字段可见性与性能差异

三种方式在运行时表现差别不小：

• structs.ToMap 内部用反射缓存了类型信息，首次调用稍慢，后续极快
• JSON 方案每次都要序列化/反序列化，小结构体开销不大，但字段多或含 slice 时明显变慢
• 手写反射版没有额外内存分配（除了结果 map），但每次都要重新遍历字段，无缓存
• 所有方案都无法处理未导出字段（首字母小写），反射拿不到值，json 和 structs 同样跳过

真正容易被忽略的是：字段标签冲突。比如你同时写了 json:"name" 和 structs:"user_name"，但只用了 json 标签做序列化，却期望 structs 库生效——它根本不会读 json 标签。说到底，选哪个方案，取决于你对类型保真度的要求，以及是否愿意多引入一个依赖。