如何将结构体快速转换为 map[string]interface{}？-Golang-PHP中文网

structs.tomap 是最省事的选择，但需注意字段标签、嵌套行为及类型丢失问题；它一行完成转换，默认读取 structs 标签，未设置时回退为大写字段名，不支持 omitempty，且整型等会丢失原始类型。

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

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 
<p>使用时注意：</p>