JSON格式化工具使用教程

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，广泛用于前后端数据交互、API 通信、配置文件存储等场景。未格式化的 JSON 往往被压缩成一行，难以阅读和排错。

本 JSON 格式化工具提供在线格式化、压缩、复制、清空四大核心功能，全部在浏览器本地完成，数据不上传服务器，适合处理接口响应、日志片段、配置文件等敏感内容。

本教程将详细介绍 JSON 格式化工具的使用方法、常见错误定位技巧，以及使用时需要注意的事项，帮助您提高日常开发效率。

1. 1

   打开 JSON 格式化工具页面，在文本框中粘贴或输入您要处理的 JSON 数据（可以是对象、数组或嵌套结构）。

2. 2

   点击顶部工具栏的「格式化」按钮，工具会对 JSON 进行语法校验，校验通过后以 2 空格缩进、换行展示，使数据层次清晰、易于阅读。

3. 3

   需要减小体积（如用于网络传输）时，点击「压缩」按钮，工具会移除所有空白、换行和缩进，生成一行紧凑的 JSON 字符串。

4. 4

   点击「复制」按钮可将结果一键复制到系统剪贴板，方便粘贴到代码编辑器、接口请求或文档中。按钮右上角会短暂提示「复制成功」。

5. 5

   如需重新输入新的数据，点击「清空」按钮可快速清空输入框并清除错误提示。

• 一键格式化，2 空格缩进，层次一目了然
• 一键压缩，移除所有空白和换行，显著减小体积
• 实时行号显示，方便定位错误位置
• 语法校验 + 错误位置自动高亮并跳转
• 一键复制到剪贴板，支持现代浏览器与旧版兼容
• 纯浏览器本地处理，数据不上传服务器，保护隐私
• 无需安装注册，打开即用，完全免费
• 支持大型 JSON（数十 MB 级别）快速处理

示例 1：格式化一段紧凑的 JSON

输入（压缩状态）：

{"name":"张三","age":25,"skills":["Java","Python","SQL"],"address":{"city":"上海","district":"浦东新区"}}

点击「格式化」后输出：

{
  "name": "张三",
  "age": 25,
  "skills": [
    "Java",
    "Python",
    "SQL"
  ],
  "address": {
    "city": "上海",
    "district": "浦东新区"
  }
}

示例 2：压缩 JSON 减小传输体积

输入（格式化状态）：

{
  "code": 200,
  "msg": "success",
  "data": [
    { "id": 1, "title": "第一篇文章" },
    { "id": 2, "title": "第二篇文章" }
  ]
}

点击「压缩」后输出（体积约减少 40%）：

{"code":200,"msg":"success","data":[{"id":1,"title":"第一篇文章"},{"id":2,"title":"第二篇文章"}]}

当输入的 JSON 格式不正确时，工具会在页面顶部显示红色错误提示，并自动计算错误所在的行号，将光标跳转到该行，便于快速修复。以下是常见错误类型：

• 1

  键名或字符串未使用双引号

  错误示例：{name: '张三'}。JSON 中所有键和字符串必须使用双引号，单引号在 JSON 中不合法。正确写法：{"name": "张三"}。

• 2

  末尾多余逗号（Trailing comma）

  错误示例：[1, 2, 3,]。JSON 标准不允许最后一项后面有逗号，需删除多余逗号后重试。

• 3

  括号或方括号不匹配、未闭合

  常见于深层嵌套结构。根据错误提示的「at position X」定位到该位置，检查附近的 { } 和 [ ] 是否成对出现。

• 4

  使用了 JSON 不支持的类型

  JSON 只支持 string / number / boolean / null / object / array 六种类型。undefined、NaN、Infinity、函数、日期对象（Date）都不能直接出现在 JSON 中，需要先做字符串转换。

• 5

  数字格式不规范

  数字不允许有前导 0（例如 0123），也不允许小数点后无数字（例如 123.）。科学计数法请使用小写 e，例如 1.2e3。

• 确保输入是合法的 JSON 字符串，包含未闭合引号、注释、JavaScript 表达式（如 //、/* */、变量引用）的数据无法被解析。
• 对于几十 MB 以上的超大 JSON，浏览器内存占用会显著增加，建议分批处理或使用后端工具。
• 请遵守相关法律法规，不要粘贴包含身份证号、手机号、密钥、密码、Token 等敏感信息到公共网络环境中使用；即使是本地处理，操作完成后也建议及时清空或关闭页面。
• 「复制」功能依赖浏览器的 Clipboard API。若浏览器权限被拒绝，会提示「复制失败」，可改用手动选中文本后 Ctrl+C（或 ⌘+C）复制。
• 若页面卡死或按钮无响应，可尝试使用浏览器刷新按钮（F5）重新加载后重试。刷新后输入框内容会被清空，请先自行保存重要数据。

• 快捷键：选中文本后使用 Ctrl+A 全选，Ctrl+Z 撤销误操作，Ctrl+Shift+Z 重做。
• 配合「JSON 转 XML / YAML」系列工具，可以先在此页面格式化和校验，再粘贴到对应转换工具中处理。
• 从浏览器 DevTools Network 面板复制的 Response，通常已经是 JSON 格式，可直接粘贴进行格式化查看。
• 压缩后的 JSON 更适合作为 API 请求体或写入文件；格式化后的 JSON 更适合代码审查和人工阅读。