JSON / FORMATTING

iPhone 如何打开 JSON、校验语法和格式化

用改阅打开 .json 文件,在文件菜单选择“JSON 校验”,检查语法通过后使用“格式化 JSON”整理缩进,或“压缩 JSON”移除排版空白。修改后另行保存,重开文件再检查关键字段。

开始之前

  • 准备实际的 .json 文本,保留原文件副本;接口返回的 HTML 错误页不是 JSON。
  • 需要服务器或云盘文件时,先确认有权限访问和保存;敏感内容无需贴到网页示例中。
  • 高级校验与格式化需要正常编辑模式,大文件轻量模式可能关闭这些入口。

操作步骤

  1. 打开文件并检查内容

    在改阅中打开 JSON,检查对象或数组以及关键字段。代码高亮用于阅读,不能代替语法校验。

  2. 先运行 JSON 校验

    从文件菜单选择“JSON 校验”。失败时检查双引号、逗号、括号和转义;修复后重新校验,不要只凭颜色判断。

  3. 按用途格式化或压缩

    “格式化 JSON”将数据整理为便于阅读的缩进文本;“压缩 JSON”用于去掉排版空白。二者都会修改当前编辑内容,保存前核对字段和值。

  4. 检查关键数据

    逐项检查字符串、数组、布尔值和 null。格式化不检查业务规则,也不保证键顺序或数字写法与原文完全相同。重要数据保留原件并与副本比较。

  5. 保存并重开

    使用“保存”或“另存为”,从实际目标位置重开,再运行一次校验。若交给程序读取,还需在该程序中检查配置或接口是否符合预期。

可以直接校验的 JSON 示例

JSON
{
  "title": "Project notes",
  "enabled": true,
  "tags": ["mobile", "draft"],
  "count": 2,
  "optional": null
}

键名与字符串使用双引号;最后一个字段后不加逗号。true 和 null 不加引号,它们与字符串的含义不同。

完成后检查

重开保存的 JSON 并校验,比较关键字段与类型,随后在实际使用它的程序中确认结果。

支持范围与限制

  • JSON 校验检查的是语法,不提供接口契约、业务字段或 JSON Schema 的完整验证。
  • 普通 JSON 不支持注释、单引号字符串和尾逗号;JSONC 或 JavaScript 对象不能直接当作标准 JSON 校验。
  • 格式化和压缩会重新序列化数据。需要保留精确数字表示、键顺序或原始字节时,应保留原文件并核对副本。

遇到问题时

看起来正确却校验失败

检查中文弯引号、尾逗号、注释、括号配对和字符串换行。确认复制的是完整 JSON,而非响应的一小部分。

格式化入口没有显示

确认扩展名为 .json,检查是否进入轻量编辑模式。可以先新建小文件,使用本页示例验证入口。

校验通过但程序仍报错

检查字段名、类型和配置要求。语法正确并不代表符合目标程序的业务规则。

常见问题

JSON 压缩会生成 ZIP 吗?

不会。这里的压缩指移除 JSON 排版空白,输出仍是 JSON 文本。打包 ZIP 属于压缩包功能。

可以直接运行 JSON 或代码吗?

JSON 是数据格式。编辑器用于查看和修改文件,代码运行或远程命令属于其他工作流。

操作说明按当前功能核对;不同版本的入口位置可能略有差异。