最可控方式是用 reflect 手动遍历字段：先通过 reflect.ValueOf 获取结构体值，解引用指针后遍历导出字段，用 Interface() 转原生值填入 map，跳过未导出字段且不 panic。

用 reflect 手动遍历字段是最可控的方式

Go 没有内置的 struct → map 转换函数，json.Marshal + json.Unmarshal 是常见取巧做法，但会丢类型、忽略未导出字段、受 tag 控制，不满足“原样映射”需求时就得自己动手。核心是用 reflect.ValueOf 获取结构体值，再遍历其字段名和值。

• 必须确保传入的是指针或值类型（不能是 nil interface{}）
• 只处理导出字段（首字母大写），未导出字段直接跳过，不会 panic
• 字段值如果是 slice/map/struct，reflect.Value.Interface() 可直接转成 Go 原生值，不用递归处理也能进 map
• 示例：

  func structToMap(v interface{}) map[string]interface{} {
      rv := reflect.ValueOf(v)
      if rv.Kind() == reflect.Ptr {
          rv = rv.Elem()
      }
      if rv.Kind() != reflect.Struct {
          return nil
      }
      m := make(map[string]interface{})
      for i := 0; i < rv.NumField(); i++ {
          field := rv.Type().Field(i)
          if !rv.Field(i).CanInterface() {
              continue
          }
          m[field.Name] = rv.Field(i).Interface()
      }
      return m
  }

用 json 包中转最简单但有隐含限制

适合快速原型或字段全是可序列化类型（string/int/bool/slice/map）的场景，本质是“序列化成 JSON 字节 → 反序列化为 map[string]interface{}”，中间绕了一圈。

• 所有字段必须可被 json 编码：不支持 func、channel、unsafe.Pointer 等
• 未导出字段（小写开头）默认被忽略，即使加了 json:"xxx" tag 也无效
• 时间类型 time.Time 会变成字符串，int64 在某些 JSON 解析器里可能变 float64
• 性能比反射略差（涉及内存分配和字节转换），但代码量最少：

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

第三方库如 mapstructure 适合带 tag 映射的场景

当 struct 字段名和目标 map key 不一致（比如 snake_case vs CamelCase），或者需要把嵌套 struct 展平、过滤字段、做类型转换时，mapstructure 比手写更稳。

Alibabacloud Sdk Client Initialization For Golang

初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。

下载

• 它读取 struct tag（如 mapstructure:"user_id"），不是靠字段名直映射
• 支持嵌套结构体自动展开、默认值填充、自定义解码函数（比如把字符串转 time.Time）
• 注意：它设计初衷是 “map → struct”，反向需配合 reflect 或先转 JSON；直接用于 struct → map 时，仍要自己处理顶层字段提取
• 别误用 Decode：它只接受 interface{} 输入，传 struct 指针进去会 panic，得先 mapstructure.Decode 到空 map，再手动塞字段

别踩 interface{} 类型断言的坑

很多示例代码在反射后直接写 m[field.Name] = rv.Field(i).Interface()，看起来没问题，但如果你后续对 map 做类型判断（比如 v, ok := m["Age"].(int)），会失败——因为 Interface() 返回的是具体类型值，但存进 map[string]interface{} 后，类型信息还在，断言却常因底层类型不符而失败（比如 int64 存进去了，你却用 int 断言）。

立即学习“go语言免费学习笔记（深入）”；

• 安全做法：如果下游强依赖具体类型，要么提前统一转成基础类型（如全转 float64），要么保留原始 struct，别转 map
• 更常见的需求其实是“只是要个可 JSON 序列化的数据容器”，那直接用 json.Marshal 中转反而更省心
• 嵌套 struct 的字段值仍是 struct{} 类型，不是 map，别假设它已经“扁平化”了

结构体转 map 看似简单，真正卡住人的往往是字段可见性、类型保真度和嵌套层级这三点。没想清楚要的是“运行时动态键值对”还是“静态结构快照”，很容易选错路。