JSON 格式化工具（JSON 格式化工具）

什么是 JSON 格式化工具？

JSON 格式化工具旨在将难以阅读的单行 JSON 或缩进混乱的 JSON 重新格式化为更易读的格式。JSON 应用于多种场景，包括 API 响应、Web 服务配置、JavaScript 应用程序中的数据交换、日志以及 NoSQL 数据库查询。然而，您实际收到的 JSON 通常缺少换行符，内容横向跨越多行，肉眼难以辨认。 当您将 JSON 粘贴到此工具中时，它会添加换行符和缩进，使键、值、数组以及嵌套结构更易于阅读。

除了格式化功能外，它还支持压缩以去除多余的空格和换行符，并提供语法检查以验证 JSON 的有效性。您可以在开发过程中检查 API 响应、编辑配置文件后验证是否存在错误，或者在将文本粘贴到聊天或文档中之前提高其可读性时使用该工具。如有需要，输出内容可以复制或下载为 JSON 文件。

本页面通过浏览器中的 JavaScript 进行处理。输入的 JSON 格式化过程不涉及向服务器提交表单。但在处理包含机密信息、个人数据、认证令牌、私钥等的 JSON 时，请在共享设备、浏览器扩展、屏幕共享及浏览器历史记录方面保持谨慎。为安全处理 JSON 内容，建议在格式化前移除不必要的信息。

• 您可以使用双空格、四空格或制表符来设置 JSON 的缩进格式。
• 您可以将 JSON 压缩为单行，并将其转换为适合传输和存储的格式。
• 您可以使用 JSON.parse 来检查缺失的逗号和不正确的引号。
• 您可以将格式化的结果复制到剪贴板，或将其保存为 formatted.json 文件。

如何使用 JSON 格式化工具

使用方法很简单。首先，将您想要格式化的 JSON 粘贴到“JSON 输入”字段中。您可以直接从 API 客户端、浏览器开发者工具、日志或配置文件等来源输入 JSON。接下来，选择您希望输出的缩进样式。虽然通常使用两个空格，但您可以选择四个空格以提高可读性，或者使用制表符以符合您现有项目的规范。

点击“格式化”按钮，系统将在解析 JSON 后显示包含换行符和缩进的输出结果。点击“压缩”按钮，系统将显示仅保留必要空格且去除换行符的单行 JSON 内容。“语法检查”功能在您希望生成输出前验证输入是否为有效 JSON 时非常有用。 若存在错误，系统将根据浏览器的解析结果显示相应提示。虽然不同浏览器显示错误的方式可能有所不同，但最常见的原因包括尾随逗号、缺少单引号、键名周围缺少引号以及缺少闭合括号。

1. 将需要格式化的 JSON 粘贴到“JSON 输入”字段中。
2. 根据需要选择使用2个空格、4个空格或一个制表符进行缩进。
3. 点击“格式”以优化文本可读性，点击“压缩”将其浓缩为单行，或点击“语法检查”以验证其准确性。
4. 查看结果，并通过“复制结果”或“下载 JSON”将其粘贴到您的应用程序中。

使用时的注意事项

• 在 JSON 中，键和字符串必须用双引号括起来。虽然这与 JavaScript 对象表示法相似，但并不完全相同。
• JSON 格式不允许行尾出现逗号。如果数组或对象的最后一个元素后有逗号，将会导致错误。
• 粘贴过大的 JSON 文件可能会导致浏览器运行缓慢。对于非常大的文件，请考虑使用专用编辑器进行查看。
• 请务必注意，在共享环境或进行屏幕共享时，切勿处理包含身份验证令牌、API 密钥或个人信息的 JSON 文件。

常见问题

什么是 JSON 格式化工具？

JSON 格式化工具可将 JSON 字符串格式化为易于阅读的格式。它会添加换行和缩进，以便更清晰地查看对象、数组、字符串、数字、布尔值、空值等元素的结构。

JSON 格式化与压缩有什么区别？

格式化是指添加换行和缩进，以便人类更轻松地阅读文本。压缩则会去除多余的空格和换行，生成适合保存或发送的简短单行 JSON 格式。

你能确认一下 JSON 是否正确吗？

是的。您可以使用“语法检查”按钮来验证您的输入是否能被解析为 JSON。如果正确，它将显示为有效的 JSON；如果存在错误，则会显示错误信息。

输入的 JSON 会发送至服务器吗？

该工具的格式化、压缩和语法检查均在浏览器中完成。在正常运行情况下，不存在向服务器提交表单以格式化 JSON 的过程。

JSON 中可以使用单引号吗？

在 JSON 中，字符串和键名必须用双引号括起来。JavaScript 风格的单引号写法在 JSON 中无效。

句尾的逗号会导致错误吗？

是的。在 JSON 中，数组或对象的最后一个元素之后不能放置逗号。虽然 JavaScript 有时允许这样做，但在 JSON 中这是错误的。

建议使用两个空格还是四个空格？

通常情况下，建议使用两个空格。若需增加间距以提高可读性，请使用四个空格；若您的项目有具体规范，请遵循相关规范。

能否处理大型 JSON 文件？

只要符合浏览器的处理能力，即可使用。但是，对于非常大的 JSON 文件，粘贴和格式化可能需要较长时间，并可能导致浏览器运行缓慢。

JSON 与 JavaScript 对象有什么区别？

JSON 是一种基于文本的数据交换格式。其规则比 JavaScript 对象字面量更为严格，例如键名和字符串必须使用双引号。其中不允许包含注释。

JSON 支持添加注释吗？

标准 JSON 不允许包含注释。因此，包含 // 或 /* */ 等注释的 JSON 风格文本将导致错误。不支持 JSONC 等格式。

我可以保存输出结果吗？

是的。您可以复制格式化或压缩后的结果。您也可以点击“下载 JSON”按钮，将其保存为 formatted.json 文件。

这是否也可用于验证 API 响应？

是的。将从 API 获取的 JSON 响应粘贴出来，可以更方便地检查嵌套结构和数组内容。这在开发、测试和调试过程中非常有用。