压缩成一行的 JSON 在排查 API 响应、日志与配置时极难阅读。本工具在本地解析并格式化或压缩 JSON，精确指出尾随逗号、单引号等语法错误位置。可与 json-diff 对比环境差异、yaml-converter 互转后再格式化，schema 级校验请用 structured-output-validator。

快速开始

粘贴 JSON

支持对象和数组。
选择缩进

可选 2/4 空格; 按团队规范对齐。
格式化或压缩

无效 JSON 会直接给出错误信息。

何时格式化 vs 压缩

格式化用于阅读：排查嵌套字段、比对 staging/production 响应、写 incident 文档时复制片段。压缩用于传输：写入环境变量、减小 Webhook payload、生成单行 fixture。格式化不改变语义，只改变空白与缩进。

常见失败原因：尾随逗号（`{"a":1,}`）、单引号、未转义换行、数字前导零。错误信息指向第一个解析失败处，比肉眼扫 4000 字符一行更快。

与 schema 校验的分工

本工具只验证 JSON 语法是否合法，不检查字段类型或必填项。合同级校验请用 **structured-output-validator** 或 **openapi-formatter**。推荐流程：格式化样本 → 肉眼发现异常 → 定义 JSON Schema → CI 中校验 API fixture。

LLM 输出常包在 Markdown 代码块里；先用 **llm-json-extractor** 提取再格式化，避免手动删反引号导致解析失败。

隐私与团队规范

本地处理意味着 JSON 不上传 Towalles 服务器，但剪贴板、截图、工单附件仍会泄露。格式化前脱敏 `authorization`、`password`、客户 ID；勿把生产 `.env` JSON 导出贴进工具。

配置 PR 中配合 **json-diff** 让 reviewer 看到语义变更而非空白噪音。超大文件（>1MB）先截取相关子树再格式化，避免标签页卡顿。

尾随逗号与 JSON 方言

标准 JSON（RFC 8259）不允许对象或数组最后一个元素后出现逗号，但 JavaScript 对象字面量、部分 JSON5 配置文件与某些 API 调试输出常带尾随逗号。本工具按严格 JSON 解析，遇到 trailing comma 会指向第一个失败位置——比肉眼扫描万字符单行 JSON 快得多。若数据来自 tsconfig 或 ESLint 的 JSONC，需先删除注释与尾随逗号，或使用支持 JSONC 的编辑器预处理后再粘贴。

单引号字符串、未转义换行符、NaN/Infinity 以及十六进制数字（0xFF）都会导致解析失败——这些在 JavaScript 中合法但 JSON 不支持。日志管道有时把多行 stack trace 直接嵌入字符串而未转义 \\\\n。格式化前先确认数据源声称的格式；YAML 配置请走 yaml-converter 而非强行当 JSON 解析。

格式化与压缩的工作流

格式化（pretty-print）不改变语义，仅插入缩进与换行，适合阅读 API 响应、对比嵌套字段、撰写 incident 文档或 PR 描述。可选择 2 或 4 空格缩进以匹配团队 Prettier/ESLint 规范。压缩（minify）移除全部非必要空白，适合写入单行环境变量、减小 Webhook body 体积或生成 curl 示例。两种模式均本地执行，不上传 JSON 内容。

推荐流程：从浏览器 Network 面板复制响应 → 本工具格式化 → 定位异常字段 → 与 staging 响应用 json-diff 对比。配置变更 PR 中，先格式化再 diff，避免「仅空白变化」淹没语义 diff。超大文件（>1MB）建议 jq 截取子树或只粘贴相关 branch，以免浏览器标签页卡顿。

语法校验与 schema 校验的分工

本工具只验证 JSON 是否Well-formed——括号匹配、字符串转义、数字格式等。它不会检查 user.email 是否为合法邮箱，或 order.total 是否必填。合同级校验应使用 JSON Schema：structured-output-validator 可粘贴 schema 与实例做本地校验；OpenAPI 文档中的 requestBody schema 可经 openapi-formatter 整理后提取。CI 中推荐 json-formatter 人工排查 + schema 自动门禁的组合。

LLM 输出常在 Markdown 代码块中夹杂 JSON。直接删除反引号可能留下 BOM 或 smart quotes。先用专用提取流程清理再格式化，可避免因首尾杂质导致的误报语法错误。token-counter 可估算格式化后 prompt 体积，防止把整份 JSON 塞进上下文窗口。

隐私与敏感字段处理

本地处理意味着 Towalles 服务器收不到 JSON，但剪贴板历史、屏幕共享与工单附件仍会传播数据。格式化前搜索并替换 authorization、password、apiKey、ssn 等字段；生产数据库导出应脱敏后再粘贴。若 JSON 来自用户上传文件，处理完毕清空编辑器并关闭标签页。

pii-scanner 适合在把日志 JSON 发给 LLM 前做模式扫描；env-diff 适合对比 .env 导出的 KEY=VALUE 与 JSON 配置中的同名键。切勿将含密钥的格式化结果提交到公开 Git 仓库——git history 难以彻底删除。

契约测试与错误响应对照

把成功/失败响应各存一份 pretty JSON，用本工具统一缩进后做人工 diff，再交给 json-diff 或 CI。字段多写、少写、类型从数字变成字符串，是联调超时的高频原因。格式化后再读，比在一行 minify 里找问题快得多。

对外 API 变更时同时更新「示例响应」文档与 fixture；评审 PR 时要求粘贴格式化后的片段，拒绝截图里的糊字。

示例

输入

Input

{"name":"towalles","tools":3,"ready":true}

Output

{
  "name": "towalles",
  "tools": 3,
  "ready": true
}

FAQ

为什么格式化失败？

通常是尾随逗号、缺少引号、括号不匹配，或混入了 JSON 不支持的注释。当前仅支持标准 JSON，不支持 JSON5。

格式化会改变数据吗？

不会。键顺序可能因解析实现略有不同，但值与结构应保持一致。若需严格键序，请在应用层控制序列化。

支持 JSON5 吗？

不支持。含注释或单引号的输入需先转为标准 JSON，或使用支持 JSONC 的编辑器。

数据会上传吗？

不会。解析与格式化完全在浏览器本地完成。

和在线 diff 工具如何配合？

两边响应都先格式化，再粘贴到 **json-diff** 对比路径级差异——比直接 diff 压缩行更易读。

格式化会改变 JSON 的语义吗？

不会。格式化与压缩仅调整空白字符，不改变键顺序（除非你的工具链另做排序）、数值、布尔值或字符串内容。Unicode 转义形式可能因解析器实现而统一，但解码后的值相同。

为什么 JSON 在 JavaScript 里能 parse 但这里报错？

JavaScript 的 JSON.parse 仍拒绝尾随逗号，但 eval 或 import 可能接受 JSON 超集。更常见的是：你复制了 JSONP、带注释的 JSONC，或单引号字符串。请对照错误位置，改为严格 JSON 或用 yaml-converter 处理 YAML 源文件。

支持 JSON Lines（NDJSON）吗？

本工具期望单个 JSON 值（对象或数组）。NDJSON 每行一个 JSON 对象，直接粘贴会失败。请逐行格式化，或先用脚本合并为数组再粘贴。日志流分析通常用命令行 jq 而非浏览器格式化。

压缩后的 JSON 如何还原可读格式？

再次粘贴压缩结果并点击格式化即可恢复缩进。压缩不可逆丢失的是空白，不是数据。建议在版本控制中保留格式化版本用于 review，部署脚本再按需压缩。

注释和尾逗号怎么办？

标准 JSON 不允许。先删注释与尾逗号再格式化；需要注释请用 JSONC 工具链并在构建时剥离。

JSON 格式化工具

在此粘贴 JSON