JSON 格式化工具怎么用?
将需要整理的数据粘贴进输入框,点击“格式化 JSON”。有效的 JSON 会在下方以两个空格缩进显示,原始输入保留在上方,方便逐行对照。“压缩”会将同一份数据写成一行。还没有数据时,可以点击“填入示例”了解界面。
复制结果后,可将其粘贴回编辑器、请求调试器或配置文件。工具只处理当前页面中的文本,不会替你发送网络请求,也不会保存编辑历史。关闭或刷新页面后,输入可能丢失,请先复制需要的结果。
常见的 JSON 错误有哪些?
JSON 的属性名与字符串必须用双引号。最后一个属性后面不能保留逗号,也不能直接写 JavaScript 注释。布尔值使用小写的 true 和 false,空值使用 null;undefined、函数和正则表达式都不是 JSON 支持的数据类型。
例如,单引号包裹的属性名在 JavaScript 对象中常见,但不能直接当作 JSON。若看到错误提示,请先检查引号是否配对、冒号与逗号的位置是否正确,以及数组或对象是否缺少右括号。工具会显示浏览器提供的错误信息,不会擅自修改存在歧义的内容。
格式化会改变原来的数据吗?
格式化采用 JSON.parse 与 JSON.stringify。常规对象、数组、字符串、布尔值和 null 可以经过解析后重新输出。空白与缩进会变化,数字的书写形式也可能被规范化,例如科学计数法可能变为普通数字。重复的对象键只保留解析后得到的最后一个值;不要将本工具用作保留重复键的编辑器。
JavaScript 数字存在精度限制。较大的订单号、数据库编号和银行卡号应当在源数据中写成字符串,避免解析时发生精度变化。原始输入若包含超过安全整数范围的数字,重新输出的结果可能与原文不同。对精度敏感的数据,请使用支持任意精度数字的专用工具。
我的输入会上传吗?
不会。JSON 的解析和输出在当前浏览器内执行。工具不把输入发送给服务器,也不将输入写入浏览器存储。网页本身仍需要通过网络加载;这与工具输入的处理是两件独立的事情。不要在公共设备上处理密码、访问令牌或真实用户资料,处理完成后及时清空输入和剪贴板。
格式化与压缩有什么区别?
格式化增加缩进与换行,适合检查嵌套层级、阅读接口响应和查看配置。压缩移除格式化所需的多余空白,适合复制到只接受单行的输入框。两种方式都需要先解析出有效的 JSON,因此不能把任意文本转换成 JSON,也不能修复所有语法问题。
示例里都有什么?
示例包含站点名称、一个工具数组和一个布尔值。你可以修改工具数组中的文字,再点击格式化观察输出;也可以故意删除一个引号,查看错误提示。输入无效时,旧结果会被清空,避免将上一次成功的内容误认为这一次的结果。
手机也能使用吗?
可以用现代手机浏览器打开。输入区域支持直接粘贴,处理按钮会根据屏幕宽度换行。较长的数据在文本框内滚动查看。手机的内存与浏览器性能有限,处理超大文件时可能出现等待,本工具没有后台上传或异步处理服务。
为什么不能复制结果?
复制按钮需要浏览器允许访问剪贴板。如果自动复制失败,工具会选中结果并提示手动复制。请使用系统的复制操作。结果为空时不会尝试覆盖剪贴板,也不会显示“复制成功”。
适合哪些日常任务?
你可以用它阅读接口返回的对象,核对配置文件中的层级,检查数组是否闭合,或将一段紧凑的数据整理成便于讨论的片段。在分享示例之前,先移除个人信息与密钥。工具只检查 JSON 语法,不验证业务字段、接口约束或某个产品专用的配置规则。
如果还需要统计说明文案的长度,可以使用字数统计;需要将文字放进 URL 查询参数时,可以使用URL 编码与解码。它们与 JSON 格式化一样在浏览器中处理输入。
JSON 与 URL 编码可以互相替代吗?
不能。JSON 描述数据结构,URL 编码用于安全表达参数值中的字符。一个 JSON 字符串如果需要作为某个查询参数的值,通常要先整理成所需 JSON 文本,再对这个参数值进行 URL 编码。接收方会先解码参数,再按接口约定解析 JSON。不要把格式化结果直接拼到任意网址中,也不要将完整网址作为单个参数编码。
输入后没有结果怎么办?
输入文本后必须点击格式化或压缩。若仍未得到结果,查看按钮下方的提示;空白输入、语法错误与复制失败会显示不同说明。示例按钮只填写输入,不会自动提交任何请求。浏览器禁用 JavaScript 时,交互处理不可用;你仍可以阅读本页的使用说明。
怎样核对处理结果?
先确认主要键名、数组长度和关键字段仍与原始数据一致,再检查数值、空值以及字符串中的转义字符。格式化不能证明数据来源可信,也不能替代接口测试。如果数据包含重复键、超大整数或特殊数值形式,应先在合适的编辑器中处理这些情况,再使用本工具做阅读整理。
如何更稳妥地分享接口示例?
先复制一份原始文本,替换姓名、邮箱、令牌、内部地址等敏感字段,再将脱敏副本放入工具。检查结果中的嵌套结构是否符合预期,确认数组条目没有因手动删除而留下多余逗号。需要保留数字原貌时,将编号用双引号包裹,避免用格式化后的数值推断原始精度。
分享给同事时,说明这是示例数据还是实际接口响应,以及哪些值经过替换。工具不会理解字段含义,也不会判断某个值是否能够对外公开。一次只处理需要检查的片段,可以减少误复制整份数据的机会。浏览器标签页关闭后没有恢复入口,必要的原始文本与处理结果应由使用者自行保存。