如何在 Go 中实现结构体与映射（map）的 JSON 平铺序列化

Go 语言不支持将 map 或 slice 嵌入 struct 以实现 JSON 平铺输出；若需生成如 {“key1”: “…”, “15/04”: 1.3} 这类无嵌套的扁平 JSON，唯一无需自定义 MarshalJSON 的方案是直接使用 map[string]interface{}。

go 语言不支持将 map 或 slice 嵌入 struct 以实现 json 平铺输出；若需生成如 `{“key1”: “…”, “15/04”: 1.3}` 这类无嵌套的扁平 json，唯一无需自定义 `marshaljson` 的方案是直接使用 `map[string]interface{}`。

在 Go 的 JSON 序列化机制中，“嵌入（embedding）”仅对 具名类型（named struct 类型） 有效，且要求被嵌入类型本身是 struct。例如：

type Metadata struct {Key1 string `json:"key1"`     Key2 string `json:"key2"`}  type Row struct {Metadata // ✅ 有效嵌入：字段被提升，JSON 输出扁平     Values   map[string]float64 `json:"-"` // ⚠️ 无法通过嵌入实现扁平化 }

但 map[string]float64（或任何 map/slice 类型）不能作为嵌入字段——它会被视为普通字段，即使使用匿名字段语法（如 RowData map[string]float64），Go 编译器也不会将其键值对“展开”到外层 JSON 对象中。你观察到的 “RowData”: {…} 嵌套结构，正是该行为的必然结果。

因此，若坚持避免实现 MarshalJSON 方法，最直接、符合 Go 惯用法的解决方案是放弃 struct 模型，改用动态映射：

package main  import ("encoding/json"     "fmt")  func main() {     row := map[string]interface{}{         "key1": "……",         "key2": "……",         "15/04": 1.3,         "15/05": 1.2,         "17/08": 0.8,}      data, _ := json.Marshal(row)     fmt.Println(string(data))     // 输出： {"15/04":1.3,"15/05":1.2,"17/08":0.8,"key1":"……","key2":"……"} }

✅ 优势：零额外逻辑、天然扁平、兼容任意键名（包括含 / 的日期字符串）
⚠️ 注意事项：

• 类型安全丢失：interface{} 需运行时断言，不适合强约束场景；
• 无法绑定方法或验证逻辑；
• 若需复用结构（如数据库行、API 响应），建议封装为工具函数或新类型（如 type Row map[string]interface{} + 辅助方法）；
• 若未来需支持反序列化（json.Unmarshal）并保证字段类型，仍需 UnmarshalJSON 或预定义 struct + json.RawMessage 等进阶方案。

总结：Go 的类型系统明确区分“组合”与“动态数据建模”。当业务本质是稀疏、键名动态（如时间序列列）、且需严格扁平 JSON 时，map[string]interface{} 不是妥协，而是最契合的设计选择。强行用 struct 建模反而增加复杂度，违背 Go“Less is more”的哲学。