reflect.MapRange 是 Go 1.12 引入的安全高效遍历 reflect.Value map 的方法，通过快照机制避免并发 panic 和重复查找；需确保输入为非 nil map 类型，使用 iter.Next() 驱动并及时读取 Key()/Value()。
reflect.MapRange 是 Go 1.12 引入的专用方法，用于安全、高效地遍历 reflect.Value 类型的 map。它不依赖 reflect.MapKeys + 逐个 MapIndex 查找，避免了键排序、重复取值、并发 panic 等问题。
为什么不能直接用 reflect.MapKeys 遍历 map？
常见错误是先调 reflect.Value.MapKeys() 得到键切片，再循环取值：
keys := v.MapKeys()
for _, k := range keys {
val := v.MapIndex(k) // ❌ 并发不安全；若 map 被修改，可能 panic
}
这在多 goroutine 修改原 map 时会触发 fatal error: concurrent map read and map write。而 reflect.MapRange 内部使用快照机制，一次遍历全程无竞态。
如何正确调用 reflect.MapRange？
必须确保 reflect.Value 是 map 类型且可寻址（但实际只需是 map，不要求地址），且非 nil。调用后返回一个迭代器 reflect.MapIter：
- 调
iter.Next()获取下一对键值 —— 返回true表示成功，false表示结束 - 每次成功后，用
iter.Key()和iter.Value()取当前项，二者均为reflect.Value - 不能在迭代中修改原 map（否则行为未定义），也不建议在循环内调
iter.Next()多次
示例：
m := map[string]int{"a": 1, "b": 2}
v := reflect.ValueOf(m)
iter := v.MapRange()
for iter.Next() {
k := iter.Key().String() // "a", "b"
val := iter.Value().Int() // 1, 2
fmt.Println(k, val)
}
reflect.MapRange 的兼容性与性能注意点
该方法仅在 Go 1.12+ 可用；低于此版本会编译失败（undefined: reflect.Value.MapRange）。若需兼容旧版，必须做构建约束或运行时检查。
- 性能上比
MapKeys+MapIndex更优：避免了键排序开销和多次哈希查找 - 不保证遍历顺序（同原生 map），但每次迭代顺序一致（因基于底层哈希桶快照）
- 对空 map，
iter.Next()直接返回false，无需额外判空 - 若传入非 map 类型的
reflect.Value，MapRange()返回 nil 迭代器，调Next()panic：panic: reflect: MapRange of non-map type
最容易被忽略的是：一旦拿到 reflect.MapIter，就必须用 Next() 驱动，不能跳过或重用；且不能把 iter.Key()/iter.Value() 的结果缓存到下一轮循环外 —— 它们指向内部临时对象，下轮调用 Next() 后内容可能被覆盖。
