json.Marshal不能直接满足扁平化需求，因为它保留嵌套结构而非生成点号路径键名；需通过递归遍历map[string]interface{}并拼接前缀实现扁平化，再按场景做URL编码或分隔符拼接。
为什么 json.Marshal 不能直接满足扁平化需求
因为 json.Marshal 会保留嵌套结构，输出类似 {"user":{"name":"Alice","addr":{"city":"Beijing"}}} 的字符串，而实际业务中（比如日志打点、HTTP 查询参数拼接、配置快照）往往需要 user.name=Alice&user.addr.city=Beijing 这种扁平键形式。这不是序列化格式问题，而是键路径展开逻辑问题 —— Go 标准库不提供开箱即用的「嵌套 map 扁平化」工具。
用递归遍历 + 点号路径拼接实现扁平化
核心思路是深度优先遍历任意嵌套的 map[string]interface{}，每层递归携带当前前缀（如 "user" → "user.addr"），遇到非 map 值就写入结果 map；遇到新 map 就继续递归。注意几个关键点：
- 必须显式检查值是否为
map[string]interface{}，其他类型（如map[interface{}]interface{}、struct）需提前转换或跳过 - 空 map 或 nil 值建议跳过，避免生成
key=这类无意义条目 - 如果 value 是 slice，常见做法是忽略（日志场景通常不展开数组），或按索引展开为
items.0.name—— 需根据业务明确策略
func flattenMap(m map[string]interface{}, prefix string) map[string]string {
result := make(map[string]string)
for k, v := range m {
key := k
if prefix != "" {
key = prefix + "." + k
}
switch val := v.(type) {
case map[string]interface{}:
sub := flattenMap(val, key)
for sk, sv := range sub {
result[sk] = sv
}
case string, int, int64, float64, bool:
result[key] = fmt.Sprintf("%v", val)
// 其他类型可按需添加，如 time.Time.Format(...)，但避免反射泛化
}
}
return result
}
序列化为 key=value 字符串时要注意 URL 编码和分隔符
扁平化后的 map[string]string 只是中间结构，最终拼接成字符串需考虑使用场景：
- 用作 HTTP query：必须对 key 和 value 分别调用
url.QueryEscape，否则空格、&、= 会破坏结构 - 用作日志字段：通常不编码，但需约定分隔符（如
;或\t），避免 value 含换行或等号干扰解析 - 键名含点号（
.）本身是合法的，但某些系统（如 Prometheus label）不支持，此时应预处理替换为_
示例拼接（query 场景）：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
q := url.Values{}
for k, v := range flatMap {
q.Set(k, v)
}
queryString := q.Encode() // 自动做 URL 编码
嵌套结构含指针或 interface{} 时容易 panic
如果原始 map 中存在 *string、interface{} 包裹的数字或切片，v.(type) 判断会失败，进入 default 分支或 panic。最稳妥的做法是加一层类型归一化：
- 在递归入口处用
reflect.ValueOf(v).Kind()判断基础类型，再转成可处理的形式 - 更轻量的方式：只支持
map[string]interface{}+ 基础值类型，其他一律跳过并记录 warn 日志（例如log.Printf("skip unsupported type %T for key %s", v, k)） - 不要试图用
json.Marshal先转成字节再解析 —— 性能差且无法控制键路径生成逻辑
真正难的不是写递归，而是定义清楚「哪些嵌套要展开」「哪些值要丢弃」「哪些字符要转义」—— 这些边界条件一旦模糊，下游解析就会出错。
