JSON操作核心是JSON.parse()和JSON.stringify()，需防范非字符串输入、BOM字符、循环引用、特殊值丢失等问题，replacer/reviver是安全扩展点，严格遵循JSON规范（双引号、无尾逗号）。
JavaScript 里操作 JSON 几乎没有“教程”这回事——JSON.parse() 和 JSON.stringify() 就是全部核心，但用错地方、传错参数、忽略边界情况，才是实际出问题的根源。
JSON.parse() 报错：Unexpected token 或 Unexpected end of JSON input
这是最常见的解析失败，本质不是语法错误，而是传入了非字符串、空值、或带 BOM/不可见字符的字符串。
-
JSON.parse(null)或JSON.parse(undefined)直接抛TypeError；必须确保输入是string类型，可用typeof input === 'string' && input.trim()防御 -
后端返回空响应体（
""）或只含空白符（"\n\t "），JSON.parse(" ")会报Unexpected token - 某些 API 返回带 UTF-8 BOM 的 JSON（如
\ufeff{"a":1}），需先用str.replace(/^\uFEFF/, '')清除 - 不要对已解析对象再调用
JSON.parse()，比如JSON.parse(JSON.parse('{"x":1}'))必然失败
JSON.stringify() 输出 undefined、null 或丢失数据
JSON.stringify() 不是无损序列化工具，它有明确的忽略规则和类型限制。
- 函数、
undefined、Symbol 值会被**静默丢弃**：JSON.stringify({a: 1, b: () => {}, c: undefined})→"{"a":1}" - 循环引用直接抛
TypeError: Converting circular structure to JSON，不能靠 try/catch 挺过去，得提前检测或用自定义 replacer 处理 - Date 对象被转成 ISO 字符串，但
new Date().toJSON()和JSON.stringify(new Date())行为一致；若需保留时间戳数字，要用replacer参数干预 -
JSON.stringify(undefined)返回undefined（不是字符串"undefined"），常导致拼接时意外变成"foo" + JSON.stringify(undefined) + "bar"→"foobar"
需要处理特殊值？别硬改 JSON，用 replacer 和 reviver
这两个参数是 JSON.stringify() 和 JSON.parse() 唯一合法的扩展点，比写正则或手动遍历安全得多。
立即学习“Java免费学习笔记（深入）”；
-
JSON.stringify(obj, (key, val) => key === 'date' ? val.getTime() : val)可把 Date 转时间戳 -
JSON.parse(str, (key, val) => key === 'ts' ? new Date(val) : val)可把数字时间戳还原为 Date - 注意：
reviver中的this指向父对象，且对顶层对象也调用一次（key为空字符串），要加判断避免误处理 - replacer 传数组可白名单字段：
JSON.stringify(obj, ['id', 'name'])，比传函数更轻量
浏览器和 Node.js 的兼容性基本不用操心，但要注意 JSON5 不是 JSON
ES5 就已内置 JSON 全局对象，所有现代环境都支持。真正容易混淆的是：有人拿 JSON5（支持注释、单引号、尾逗号）当 JSON 用，结果在生产环境崩。
-
JSON.parse('{ "a": 1, }')在严格 JSON 下报错；JSON5 才允许尾逗号 -
JSON.parse("{'a': 1}")同样非法——JSON **只认双引号**，单引号是常见误判点 - Node.js 里
require('./config.json')是 CommonJS 行为，底层调用的是fs.readFileSync+JSON.parse，所以依然受 JSON 规范约束
真正难的从来不是“怎么调用”，而是你拿到的数据到底是不是 JSON 字符串、有没有被中间层悄悄改过格式、以及要不要在序列化前后做类型归一化——这些没法靠查文档解决，得看 network 面板、打日志、甚至抓包确认原始 payload。
