JSON 格式化：验证、压缩和美化打印

2026年3月31日 · 12分钟阅读

JSON（JavaScript 对象表示法）已成为网络上数据交换的通用语言。无论您是构建 REST API、配置应用程序还是存储结构化数据，了解如何正确格式化、验证和优化 JSON 对于现代开发都至关重要。

本综合指南探讨了您需要了解的关于 JSON 格式化的所有内容——从基本语法规则到高级优化技术。您将学习如何验证 JSON 数据、何时使用美化打印与压缩，以及如何排查可能破坏应用程序的常见错误。

理解 JSON 语法和结构

JSON 遵循一套严格的规则，确保在不同编程语言和平台之间的一致性。理解这些基本原则将为您节省无数小时的调试时间，并帮助您编写更清晰、更易维护的代码。

字符串键是必需的

JSON 对象中的每个键都必须是用双引号括起来的字符串。这不是可选的——这是 JSON 规范的核心要求。单引号不起作用，未加引号的键会导致解析错误。

{
  "name": "Alice",
  "age": 30,
  "isActive": true
}

存在这种严格要求是因为 JSON 解析器需要一种一致的方式来识别不同编程环境中的键。虽然 JavaScript 允许对象字面量中使用未加引号的键，但 JSON 不允许。

JSON 中的数据类型

JSON 支持六种基本数据类型，每种都有特定的格式规则：

逗号规则和尾随逗号

JSON 在逗号放置方面是不宽容的。与 JavaScript 不同，JSON 不允许在数组或对象的最后一个元素后使用尾随逗号。

有效的 JSON：

{
  "users": ["Alice", "Bob", "Charlie"],
  "count": 3
}

无效的 JSON（尾随逗号）：

{
  "users": ["Alice", "Bob", "Charlie",],
  "count": 3,
}

这是手动编辑 JSON 文件时最常见的错误之一。许多来自 JavaScript 开发的代码编辑器允许尾随逗号，这在使用 JSON 时可能会导致混淆。

嵌套结构和深度

JSON 支持对象和数组的任意嵌套，允许您表示复杂的层次数据结构。但是，过度嵌套会影响可读性和解析性能。

{
  "company": {
    "name": "TechCorp",
    "departments": [
      {
        "name": "Engineering",
        "employees": [
          {
            "id": 1,
            "name": "Alice",
            "skills": ["JavaScript", "Python", "Go"]
          }
        ]
      }
    ]
  }
}

JSON 格式化策略：美化打印与压缩

JSON 的格式化方式完全取决于您的用例。美化打印使 JSON 易于人类阅读，而压缩则减少生产环境的文件大小。了解何时使用每种方法对于高效的开发工作流程至关重要。

开发时的美化打印

美化打印添加空格、缩进和换行符，使 JSON 易于阅读和调试。这种格式在开发、代码审查和文档编写期间非常理想。

美化打印的好处：

• 更容易发现语法错误和结构问题
• 简化调试和故障排除
• 使版本控制差异更易读
• 改善团队成员之间的协作
• 有助于手动编辑和配置

大多数 JSON 格式化工具提供根据团队编码标准自定义缩进（2个空格、4个空格或制表符）的选项。

{
  "api": {
    "version": "2.0",
    "endpoints": [
      "/users",
      "/posts",
      "/comments"
    ],
    "rateLimit": 1000
  }
}

生产环境的压缩

压缩的 JSON 删除所有不必要的空格，减少文件大小并提高传输速度。这对于生产 API、移动应用程序以及任何带宽重要的场景都是必不可少的。

上述内容的压缩版本：

{"api":{"version":"2.0","endpoints":["/users","/posts","/comments"],"rateLimit":1000}}

压缩版本小了 40%，这意味着在大规模情况下加载时间更快，带宽成本更低。

何时使用每种格式

JSON 验证技术和最佳实践

验证确保您的 JSON 在到达生产环境之前在语法上是正确的并且结构上是健全的。无效的 JSON 可能会导致应用程序崩溃、数据损坏并产生安全漏洞。

在线验证工具

在线 JSON 验证器提供关于语法错误的即时反馈，使它们在开发过程中非常宝贵。这些工具通常会突出显示错误的确切位置并建议修复方法。

要寻找的关键功能：

• 逐行错误报告，带有特定的错误消息
• 语法高亮以便更容易的视觉解析
• 支持大文件（10MB+）
• 注重隐私的验证（客户端处理）
• 更正后的 JSON 的导出选项

程序化验证

对于自动化工作流程，程序化验证是必不可少的。大多数编程语言提供内置的 JSON 解析，在无效输入时抛出错误。

JavaScript 示例：

function validateJSON(jsonString) {
  try {
    JSON.parse(jsonString);
    return { valid: true };
  } catch (error) {
    return { 
      valid: false, 
      error: error.message,
      position: error.message.match(/position (\d+)/)?.[1]
    };
  }
}

Python 示例：

import json

def validate_json(json_string):
    try:
        json.loads(json_string)
        return {"valid": True}
    except json.JSONDecodeError as e:
        return {
            "valid": False,
            "error": str(e),
            "line": e.lineno,
            "column": e.colno
        }

模式验证

除了语法验证之外，模式验证确保您的 JSON 数据与预期的结构和数据类型匹配。JSON Schema 是定义和验证 JSON 文档结构的标准。

JSON Schema 示例：

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1
    },
    "age": {
      "type": "integer",
      "minimum": 0,
      "maximum": 150
    },
    "email": {
      "type": "string",
      "format": "email"
    }
  },
  "required": ["name", "email"]
}

模式验证捕获语法验证遗漏的逻辑错误，例如缺少必需字段、不正确的数据类型或超出可接受范围的值。

排查常见 JSON 错误

即使是经验丰富的开发人员也会遇到 JSON 错误。了解最常见的错误以及如何快速修复它们对于保持生产力至关重要。

尾随逗号

这是最常见的 JSON 错误，特别是对于来自允许尾随逗号的 JavaScript 的开发人员。

错误消息：Unexpected token } in JSON at position 45

问题：

{
  "name": "Alice",
  "age": 30,
}

解决方案：

{
  "name": "Alice",
  "age": 30
}

单引号而不是双引号

JSON 要求字符串使用双引号。单引号会在大多数 JSON 解析器中导致解析错误。

错误消息：Unexpected token ' in JSO