怎样使用javascript操作json数据【教程】

javaScript操作jsON只需json.parse()和JSON.stringify()，常见错误源于格式不合法、类型不兼容或忽略异步特性；须校验数据源、加try/catch、避免循环引用，并区分JSON字符串与JS对象。

javascript 操作 JSON 数据不需要额外库，核心就两件事：JSON.parse() 和 JSON.stringify()。用错函数、忽略类型转换、或在非标准 JSON 上强行解析，是 90% 的问题根源。

JSON.parse() 报错：Unexpected Token 或 Unexpected end of JSON input

这是最常见错误，本质是传入的字符串不是合法 JSON 格式。注意：JavaScript 对象字面量（如 {name: 'Alice'}）不是 JSON；JSON 要求键名和字符串值必须用双引号，且不支持尾逗号、注释、undefined、函数等。

• 检查原始数据来源：后端返回是否真为 Content-Type: application/json？前端拼接字符串时有没有漏掉引号或写错括号？
• 用浏览器开发者工具的 Network 面板查看响应体原文，复制出来粘贴到 JSONLint 验证
• 不要对 NULL、undefined 或已解析过的对象再调用 JSON.parse() —— 它只接受字符串
• 安全做法：加 try/catch，避免整个流程崩掉：

  try {   const data = JSON.parse(rawString); } catch (e) {   console.error('JSON 解析失败:', e.message); }

JSON.stringify() 后数据“消失”或变成空对象

JSON.stringify() 会忽略 undefined、函数、symbol 类型的属性，也会跳过循环引用。如果输出是 "{}" 或 "null"，大概率是输入值本身不可序列化。

• 传入 undefined、function、Symbol 时，结果分别是 "undefined"（顶层）、"null"（对象属性中）、undefined（被忽略）
• 传入 NaN 或 Infinity，结果是 "null"
• 遇到循环引用（比如 obj.a = obj），直接抛 TypeError: Converting circular structure to JSON
• 需要保留特殊值？自己写 replacer 函数，例如过滤掉 undefined：

  JSON.stringify(obj, (key, value) => value === undefined ? null : value)

修改 JSON 数据前必须先 parse，不能直接改字符串

JSON 是数据交换格式，本质是字符串。想增删改查字段，必须先转成 JavaScript 对象（或数组），操作完成后再 stringify 回去。直接字符串替换极易出错，且无法处理嵌套、转义、键名含特殊字符等情况。

立即学习“Java免费学习笔记（深入）”；

• 错误示范：jsonStr.replace('"age":25', '"age":26') —— 如果 age 在多层嵌套里、或有其他字段也含 “age” 字符串，就挂了
• 正确流程：const obj = JSON.parse(jsonStr); obj.age = 26; const newJson = JSON.stringify(obj);
• 注意引用关系：如果对象很大，又只需要改一两个字段，JSON.parse() 会完整深拷贝一次，内存和性能需留意

从 fetch 获取 JSON 时，别忘了 .json() 是异步方法

很多人以为 fetch(url).then(res => res.json()) 返回的是解析好的对象，其实它返回的是 promise。没 await 或没链好 then，拿到的就是 pending 状态的 Promise，不是数据本身。

• 错误：const data = fetch('/api/user').then(r => r.json()); console.log(data); // Promise {}
• 正确（async/await）：

  const res = await fetch('/api/user'); const data = await res.json(); // 注意这里也要 await

• 正确（Promise 链）：

  fetch('/api/user')   .then(res => res.json())   .then(data => console.log(data));

• 务必检查 res.ok，http 错误状态码（如 404、500）不会导致 Promise reject，但 res.json() 仍会执行 —— 可能解析空响应体而报错

真正容易被忽略的点是：JSON 不是万能容器。时间用 date 对象，二进制用 ArrayBuffer，复杂嵌套结构要考虑是否该用类或 map 替代纯对象。别为了“看起来像 JSON”而硬塞所有东西进字符串来回 parse/stringify。