JSON.parse()无法直接还原Map，因JSON标准仅支持字符串键且不包含Map类型；需手动转换：方案一用[...map]转二维数组再new Map()；方案二用reviver识别{"$map":true}结构；方案三封装递归工具函数处理嵌套。
JavaScript 原生的 JSON.parse() 无法直接还原 Map，因为 JSON 标准不支持键值对集合类型，且 Map 的键可以是任意类型（如对象、函数），而 JSON 只支持字符串作为键。所以需要手动转换：先解析 JSON 得到普通对象或数组，再按约定结构重建 Map。
方案一：序列化时就保留 Map 结构信息
推荐在保存前把 Map 转为可序列化的格式，比如二维数组 [[key, value], [key, value], ...]，这样反序列化时能明确还原：
- 序列化：
JSON.stringify([...myMap]) - 反序列化：
new Map(JSON.parse(jsonStr))
✅ 优点：简洁、可靠、支持任意类型的 key（只要 key 本身可被 JSON 序列化）；
⚠️ 注意：若 key 是函数、undefined、Symbol 或循环引用，仍会丢失或报错 —— 这是 JSON 本身的限制，与 Map 无关。
方案二：用自定义 reviver 处理嵌套结构
如果 JSON 字符串里某个字段本应是 Map（例如 {"cache": [["a", 1], ["b", 2]]}），可在 JSON.parse() 的第二个参数 reviver 中识别并转换：
- 约定一个标记，比如用
{"$map": true, "data": [...]}包裹数组 - 在 reviver 中检测该结构，返回
new Map(value.data)
示例：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
const json = '{"user": "Alice", "permissions": {"$map": true, "data": [["read", true], ["write", false]]}}';
const obj = JSON.parse(json, (key, value) => {
if (value && typeof value === 'object' && value.$map && Array.isArray(value.data)) {
return new Map(value.data);
}
return value;
});
// obj.permissions 是 Map { 'read' => true, 'write' => false }
方案三：封装可复用的工具函数
为避免重复写逻辑，可封装成两个函数：
-
mapToJson(map)→ 返回带类型提示的 JSON 兼容对象 -
jsonToMap(jsonStr)→ 自动识别并还原 Map（支持嵌套）
关键点：递归遍历解析后的值，对符合 { $type: 'Map', value: [...] } 形式的对象执行 new Map(val.value)，其余保持原样。
为什么不直接用 JSON.parse(...).then(Map)？
JSON.parse() 返回的是普通对象或数组，不是可迭代对象（除非你显式展开）。new Map(obj) 会报错，因为 Map 构造器只接受可迭代对象（如数组、Set、其他 Map），不接受普通对象 —— 即使对象有 keys() 方法也不行。必须确保传入的是 [[k,v],[k,v]] 这样的二维数组形式。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
