JSON 工具完全指南：格式化、校验、比对与 Path 查询

最后更新：2026年3月26日 | 阅读时间约 10 分钟

一、JSON 格式基础教程

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，由 Douglas Crockford 在 2001 年提出。它基于 JavaScript 编程语言的一个子集，但独立于编程语言，几乎所有现代编程语言都支持 JSON 的解析和生成。

JSON 已经成为 Web 开发中最主流的数据交换格式，几乎所有的 RESTful API 都使用 JSON 作为请求和响应的数据格式。理解 JSON 的语法规则是每个开发者的必备技能。

1.1 JSON 的基本数据类型

1.2 JSON 语法规则

JSON 的语法规则非常严格，以下是必须遵守的核心规则：

• 键名必须用双引号：{"name": "张三"} 是合法的，{name: "张三"} 不是合法的 JSON
• 字符串值必须用双引号：不支持单引号包裹字符串
• 不支持注释：标准 JSON 不支持 // 或 /* */ 形式的注释（JSONC 格式支持）
• 不支持尾逗号：{"a": 1,} 中的尾逗号会导致解析错误
• 不支持 undefined：JSON 只有 null，没有 undefined
• 特殊字符需要转义：字符串中的双引号用 \" 转义，换行用 \n 转义

1.3 JSON 与 XML 的对比

二、JSON 格式化与美化

JSON 格式化（JSON Formatting / Pretty Print）是将压缩的单行 JSON 字符串转换为带有缩进的易读格式。这是日常开发中最频繁使用的 JSON 操作之一。

2.1 什么时候需要格式化？

• 调试 API 响应：从后端接口收到的 JSON 通常是压缩格式，格式化后才能看清数据结构
• 阅读配置文件：package.json、tsconfig.json 等配置文件需要良好的缩进才能理解
• 代码审查：在代码中嵌入的 JSON 字符串需要格式化以提高可读性
• 编写文档：在技术文档中展示 JSON 示例时，需要格式化以提高可读性

2.2 在线格式化工具

使用 JSON 格式化工具 只需三步：粘贴压缩的 JSON 文本，点击"格式化"按钮，即可得到带缩进的美化结果。优质的格式化工具还支持自定义缩进空格数（2空格或4空格）。

对于需要将格式化后的 JSON 压缩回单行的场景，可以使用 JSON 压缩工具，减少 JSON 文件的体积，适合在生产环境中传输。

三、JSON 校验与错误修复

JSON 校验是验证一段文本是否符合 JSON 语法规范的过程。由于 JSON 语法非常严格，一个小小的语法错误就会导致整个 JSON 无法解析。使用 JSON 校验工具可以快速发现并定位错误。

3.1 常见 JSON 错误及修复方法

3.2 校验技巧

• 使用在线校验工具粘贴 JSON 文本，工具会高亮显示错误位置和原因
• 在代码中使用 try-catch 包裹 JSON.parse() 调用，捕获语法错误
• 在浏览器开发者工具的 Console 面板中直接粘贴 JSON.parse('...') 测试
• 使用 VS Code 等编辑器打开 .json 文件，编辑器会自动检测语法错误

四、JSON 比对与差异分析

JSON 比对工具用于比较两段 JSON 数据之间的差异。这在开发和测试中非常有用。

4.1 使用场景

• API 测试：比较实际 API 响应与预期响应的差异
• 版本对比：比较不同版本的配置文件差异
• 数据同步验证：验证两个数据源之间的数据是否一致
• Bug 排查：比较正常数据和异常数据，找出差异点
• 代码审查：比较提交前后的 JSON 配置变化

4.2 使用在线比对工具

使用 JSON 比对工具，将两段 JSON 分别粘贴到左右面板，点击"比对"即可看到差异。好的比对工具会以不同颜色标注新增、删除和修改的字段，让你一目了然地看到两段 JSON 的所有差异。

五、JSONPath 查询教程

JSONPath 是一种用于从 JSON 文档中提取特定数据的查询语言，类似于 XML 的 XPath。它在 API 测试、数据提取和自动化脚本中非常实用。

5.1 JSONPath 基本语法

5.2 实际使用示例

假设有以下 JSON 数据：

{
  "store": {
    "books": [
      {"title": "JavaScript高级编程", "price": 89},
      {"title": "Python入门", "price": 59},
      {"title": "算法导论", "price": 128}
    ],
    "location": "北京"
  }
}

常用 JSONPath 表达式：

• $.store.books - 获取所有书籍
• $.store.books[0].title - 获取第一本书的标题
• $.store.books[?(@.price > 80)].title - 获取价格大于80的书名
• $..price - 获取所有价格字段

使用 JSONPath 查询工具，粘贴 JSON 数据和查询表达式，即可实时查看匹配结果。

六、其他常用 JSON 工具

6.1 JSON 编辑器

JSON 编辑器提供类似 IDE 的编辑体验，支持语法高亮、自动补全、实时校验。当你需要手动编辑大型 JSON 文件时，专用的 JSON 编辑器比普通文本编辑器好用得多。

6.2 JSON 与其他格式互转

• JSON 转 YAML：在配置管理中，YAML 比 JSON 更易读，常用于 Kubernetes、Docker 等场景
• JSON 转 CSV：将 JSON 数组数据转换为 CSV 表格格式，方便在 Excel 中打开分析
• JSON 美化：快速将压缩的 JSON 转换为格式化的可读形式

6.3 JSON 数据处理

• CSV 转 Markdown：将结构化数据转换为 Markdown 表格
• Base64 编解码：JSON 数据的 Base64 编码和解码

七、为什么开发者需要在线 JSON 工具？

虽然大多数编程语言和 IDE 都内置了 JSON 处理能力，但在线 JSON 工具仍然有其不可替代的优势：

• 即开即用：无需安装任何软件或插件，打开浏览器就能用
• 跨设备：在手机上也能快速查看和格式化 JSON 数据
• 功能聚焦：每个工具专注一件事，界面简洁，操作高效
• 数据安全：优质工具（如 eitools.cn）在浏览器端处理数据，不上传服务器
• 分享方便：将工具链接分享给同事，对方无需安装任何东西
• 持续更新：在线工具可以快速迭代，添加新功能不需要用户升级

八、总结

JSON 是现代 Web 开发的基石，掌握 JSON 工具的使用可以显著提升开发效率。从基础的格式化和校验，到高级的比对和 JSONPath 查询，一套完整的 JSON 工具集是每个开发者的必备利器。推荐将常用的 JSON 工具加入书签，在需要时快速访问。