为什么 JSON 需要格式化?
JSON(JavaScript Object Notation)是当今互联网最流行的数据交换格式。接口调试、配置文件、日志分析、数据存储——几乎每一个开发环节都离不开它。然而服务器返回的 JSON 往往被压缩成一行,几千个字符挤在一起,根本无法阅读。
JSON 格式化(也叫 JSON 美化、JSON Pretty Print)就是把压缩的 JSON 按照层级缩进重新排版,让数据结构一目了然。同时一个合格的格式化工具还应该具备语法校验功能:当 JSON 存在逗号缺失、引号不匹配等问题时,能精确指出错误位置。
方法一:在线 JSON 格式化工具(最快,推荐)
对于 90% 的日常场景,在线工具是最快的选择:打开网页、粘贴、完成,全程不到 10 秒。不需要安装任何软件,手机、平板、公司电脑都能用。
以工具集的 JSON 格式化工具为例,它支持格式化、压缩、校验、转义/去转义、键排序等功能,全部在浏览器本地运行,数据不上传服务器,即使是包含敏感信息的接口数据也可以放心使用。
- 打开工具页面,将 JSON 文本粘贴到输入框
- 点击「格式化」按钮,自动完成缩进排版与语法校验
- 如有语法错误,会提示具体的错误位置与原因
- 可一键复制结果,或切换「压缩模式」反向操作
方法二:VS Code 内置格式化
如果你正在用 VS Code 写代码,内置的格式化功能足够好用。打开 JSON 文件后,按下 Shift + Alt + F(Mac 为 Shift + Option + F)即可完成格式化。
VS Code 的优势是与编辑器工作流无缝衔接,劣势是必须先创建文件——临时调试接口时粘贴一段 JSON 还要新建文件,步骤略显繁琐。
方法三:命令行工具(适合批量处理)
Linux/macOS 自带的 python 命令可以快速格式化 JSON:cat data.json | python -m json.tool。如果安装了 jq,则 jq . data.json 更加强大,支持字段过滤、转换等操作。
命令行方案适合写脚本批量处理大量 JSON 文件,或者嵌入到 CI/CD 流水线中。但对不熟悉终端的用户门槛较高。
方法四:浏览器插件
Chrome 的 JSONView、Firefox 内置的 JSON 查看器可以在浏览器直接打开接口地址时自动格式化返回内容。这类插件适合经常直接在浏览器访问 REST API 的开发者。
需要注意的是,浏览器插件会读取你访问的所有页面数据,选择插件时应优先考虑开源、评分高、更新频繁的产品。
方法五:代码实现
几乎所有语言都内置了 JSON 格式化能力。JavaScript 中 JSON.stringify(data, null, 2) 的第三个参数控制缩进空格数;Python 中 json.dumps(data, indent=2, ensure_ascii=False) 同理;Java 可以用 Jackson 或 Gson 的 pretty print 模式。
代码方案适合在程序内部输出可读日志、生成配置文件等自动化场景。
5 种方法对比总结
综合来看:日常临时使用首选在线工具(零成本、跨设备);深度编码时用编辑器内置功能;批量自动化用命令行;浏览器直连 API 用插件;程序内部用代码实现。
无论选择哪种方式,核心诉求都一样:快、准、安全。特别是处理包含用户数据的 JSON 时,务必选择本地处理的工具,避免数据经第三方服务器泄露。