JSON 详解：基础、语法与开发者实用指南

By 佐川 直弘 | Naohiro Sagawa (運営者)

※記事内に広告を含みます。Amazonアソシエイトとして適格販売により収入を得ています。　

1. 什么是 JSON？从基础了解数据格式

JSON 的定义与核心概念

JSON 是一种基于文本的数据格式，主要使用键‑值对来表示信息。这种结构非常适合在程序之间交换数据。

例如，用户信息可以用 JSON 表示如下。

{
  "name": "Sato",
  "age": 30,
  "email": "sato@example.com"
}

在此示例中，键为 name、age 和 email，每个键都映射到相应的值。这使得数据既易于人类阅读，又便于计算机处理。

JSON 的关键特性与优势

1. 轻量且简洁

• JSON 是一种紧凑的格式，避免了不必要的信息，从而在数据传输和存储方面更高效。

2. 高可读性

• 与 XML 或二进制格式相比，JSON 在视觉上更易于理解，简化了调试和维护工作。

3. 语言无关

• JSON 被众多编程语言支持，包括 JavaScript，具备跨平台的高兼容性。

4. 面向对象友好

• JSON 以面向对象的结构为设计基础，非常适合面向对象编程。

为什么 JSON 被广泛采用

由于 JSON 基于 JavaScript 对象语法，它迅速成为 Web 应用开发中的标准数据格式。

尤其是，JSON 因其简洁性和兼容性，在 REST API 的数据交换中被广泛使用。相较于 XML，JSON 所需代码更少，解析速度更快，因而非常适合移动应用和云服务。

JSON 的常见使用场景

1. API 请求与响应

• JSON 被广泛用作 Web 服务之间的数据交换格式。例如，天气 API 通常返回 JSON 格式的数据。

2. 配置文件

• JSON 常用于存储应用设置，如 config.json 等配置文件。

3. 数据存储与数据库

• NoSQL 数据库（如 MongoDB）使用基于 JSON 的格式作为数据模型。

4. 数据分析与日志管理

• JSON 也用于分析和错误日志，因为其结构化格式简化了数据解析。

小结

JSON 是一种 轻量且简洁的数据交换格式，已在编程语言、数据库和 API 中得到广泛采用。凭借其可读性和灵活性，既适合初学者，也适合高级开发者使用。

在下一节中，我们将更详细地探讨 JSON 语法，使用真实代码示例加深你的理解。

2. 基本的 JSON 语法与结构

JSON 的核心结构

JSON 以 键‑值对 作为基本元素构建。数据使用大括号 {} 编写，如下所示。

示例：表示用户信息的 JSON

{
  "name": "Sato",
  "age": 30,
  "email": "sato@example.com",
  "isMember": true
}

• 键（例如 "name"、"age"）必须始终写成字符串。
• 值 可以是字符串、数字、布尔值、null、数组或对象。

数据类型与示例

1. 字符串

• 必须使用双引号括起。
• 示例："title": "Introduction to JSON"

2. 数字

• 支持整数和浮点数。
• 示例："price": 1999, "discount": 9.5

3. 布尔值

• 使用 true 或 false 表示。
• 示例："isAvailable": true

4. null

• 表示值的缺失。
• 示例："nickname": null

5. 数组

• 使用方括号 [] 表示值的列表。
• 示例："tags": ["JSON", "Data Format", "Programming"]

6. 对象

• 对象可以嵌套在其他对象内部。
• 示例："address": { "city": "Tokyo", "zip": "100-0001" }

编写 JSON 时的重要规则

1. 始终使用双引号

• 键和字符串值必须使用双引号括起。单引号会导致错误。

1. 不允许尾随逗号

• 在数组或对象的最后一个元素后添加尾随逗号会导致错误。
• 无效示例： { "name": "Sato", "age": 30, }

1. 不支持注释

• 标准 JSON 不允许注释。文档应另行编写，例如放在 README 文件中。

摘要

JSON 通过键值对、数组和对象实现高效的数据管理。其结构简单而灵活，使其成为数据交换和存储的理想选择。

3. JSON 使用的实际示例

通过 API 进行数据交换

JSON 被广泛用作服务器与 Web 或移动应用之间的数据交换格式。尤其在 REST API 中，JSON 通常被采用为请求和响应的标准格式。

示例：获取用户信息的 API

• 请求

  GET /users/1 HTTP/1.1
  Host: example.com
  Accept: application/json
  

• 响应

  HTTP/1.1 200 OK
  Content-Type: application/json
  
  {
    "id": 1,
    "name": "Sato",
    "email": "sato@example.com",
    "status": "active"
  }
  

将 JSON 用作配置文件

JSON 也被用作应用程序的配置格式。

示例：配置文件 (config.json)

{
  "server": {
    "host": "localhost",
    "port": 3000
  },
  "database": {
    "user": "admin",
    "password": "password123",
    "dbname": "exampledb"
  },
  "logging": {
    "level": "info",
    "enabled": true
  }
}

前端与后端之间的数据通信

JSON 常用于 AJAX 或 Fetch API 的异步通信。

示例：使用 Fetch API 获取数据（JavaScript）

fetch('https://api.example.com/users/1')
  .then(response => response.json())
  .then(data => {
    console.log(data.name); // Displays "Sato"
  })
  .catch(error => console.error('Error:', error));

在数据库中使用 JSON（NoSQL）

NoSQL 数据库以基于 JSON 的格式存储和管理数据。

示例：在 MongoDB 中保存数据

{
  "_id": ObjectId("507f1f77bcf86cd799439011"),
  "name": "Tanaka",
  "age": 28,
  "skills": ["JavaScript", "Python"]
}

摘要

JSON 在许多场景中都是必不可少的格式，包括 API 通信、配置文件、数据库以及日志管理。

4. 如何使用和处理 JSON

在 JavaScript 中解析和生成 JSON

解析 JSON

const jsonString = '{"name": "Tanaka", "age": 25, "isMember": true}';
const user = JSON.parse(jsonString);

console.log(user.name);  // Output: Tanaka

生成 JSON（序列化）

const user = {
  name: "Tanaka",
  age: 25,
  isMember: true
};

const jsonString = JSON.stringify(user, null, 2);
console.log(jsonString);

在其他编程语言中使用 JSON

Python 示例

import json

json_str = '{"name": "Sato", "age": 28}'
data = json.loads(json_str)
print(data['name'])  # Output: Sato

错误处理

JavaScript 示例

try {
  const data = JSON.parse('{name: "Sato"}'); // Error occurs
} catch (error) {
  console.error('JSON parsing error:', error.message);
}

摘要

由于 JSON 易于解析和生成，它在众多应用中实现了高效的数据管理。

5. JSON 的高级用法及现代技术

使用 JSON Schema 进行数据验证

JSON Schema 是一种用于定义和验证 JSON 数据结构和格式的规范。

示例：用户信息的 Schema

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

使用 JSON-LD 的结构化数据

JSON-LD 为搜索引擎提供语义丰富的数据，且被广泛用于 SEO 优化。

示例：结构化公司信息

{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Sample Corporation",
  "url": "https://www.example.com",
  "contactPoint": {
    "@type": "ContactPoint",
    "telephone": "+81-90-1234-5678",
    "contactType": "customer service"
  }
}

最新规范和扩展技术

示例：JSON5

{
  name: "Tanaka", // Comments are allowed
  age: 30,
  skills: ["JavaScript", "Python",], // Trailing commas are allowed
}

摘要

JSON 支持广泛的高级用例，包括验证和 SEO 优化，使其成为高度多功能的数据格式。

6. JSON 与其他数据格式的比较

JSON 与 XML 的比较

示例：JSON

{
  "user": {
    "name": "Sato",
    "age": 30
  }
}

示例：XML

<user>
  <name>Sato</name>
  <age>30</age>
</user>

比较表

JSON 与 YAML 的比较

示例：JSON

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

示例：YAML

name: Sato
age: 30

比较表

摘要

JSON 在简洁性和速度方面表现出色，使其非常适合数据管理和 API 通信。

7. JSON 的未来与新兴趋势

JSON 的标准化与演进

JSON 已在 RFC 8259 中标准化，并使用 UTF-8 作为默认编码。

JSON5 的出现

JSON5 是一种扩展规范，引入了更灵活的语法并支持注释。

JSON5 示例

{
  name: "Tanaka",
  age: 25, // Comments are allowed
}

JSON-LD 与语义网

JSON-LD 支持 SEO 增强和语义数据标注，使搜索引擎能够使用结构化数据。

未来挑战

• 性能： 向二进制格式（如 BSON）迁移。
• 安全性： 改进的转义机制和验证工具。

摘要

JSON 随着现代技术不断演进，并在数据管理系统中发挥核心作用。

8. 摘要与额外资源

关键要点

• JSON 被广泛采用，作为一种简单高效的数据交换格式。
• 它用于 API、配置文件以及与 SEO 相关的结构化数据。
• 与现代技术和安全措施的集成持续推进。

额外资源

• 官方 JSON 网站 – JSON 的规范和基本规则。
• JSONLint – JSON 语法验证工具。
• MDN Web Docs – JavaScript 的 JSON 文档。

下一步与实用建议

1. 在小型项目中使用 JSON，以获得实践经验。
2. 学习高级技术，如 JSON Schema 和 JSON-LD。
3. 通过开发者社区和论坛保持对最新趋势的了解。

摘要

JSON 简化了数据管理，并在与现代技术结合时持续扩展其能力。

FAQ：关于 JSON 的常见问题

1. 什么是 JSON？

答： JSON（JavaScript 对象表示法）是一种基于文本的数据交换格式，旨在以简洁高效的方式表示数据。

• 它由键-值对组成，清晰地表达数据结构。
• 它轻量且被众多编程语言支持，非常适合用于 API 和配置文件。

2. JSON 通常用于哪些场景？

答： JSON 在以下场景中使用。

1. API 通信： 在客户端和服务器之间发送和接收数据。
2. 配置文件： 存储应用程序和工具的设置。
3. 数据库： 管理 NoSQL 数据库（如 MongoDB）中的数据。
4. 日志管理： 记录错误日志和调试信息。
5. 结构化数据： 使用 JSON‑LD 进行 SEO 优化。

3. JSON 支持哪些数据类型？

答： JSON 支持以下六种数据类型。

1. 字符串： "name": "Sato"
2. 数字： "age": 30
3. 布尔值： "isMember": true
4. null： "nickname": null
5. 数组： "skills": ["JavaScript", "Python"]
6. 对象： "address": {"city": "Tokyo", "zip": "100-0001"}

4. JSON 与 XML 有何区别？

答： JSON 与 XML 的关键区别如下所示。

5. JSON 与 YAML 有何不同？

答： YAML 是一种面向人类的友好数据格式，在以下方面与 JSON 不同。

6. 哪些编程语言支持 JSON？

答： 多种编程语言都支持 JSON。

• JavaScript： 使用 JSON.parse() 和 JSON.stringify()。
• Python： 使用 json 模块。
• PHP： 使用 json_decode() 和 json_encode()。
• Java： 使用诸如 Jackson 或 Gson 的库。

7. 可以在 JSON 中添加注释吗？

答： 标准 JSON 不支持注释。不过，以下替代方案常被使用。

1. 添加仅用于注释的键：

   {
     "_comment": "This setting is for debugging",
     "debug": true
   }
   

2. 使用 JSON5： JSON5 支持注释。

8. 应该如何处理 JSON 错误？

答： 以下示例展示了如何处理与 JSON 相关的错误。

JavaScript 示例：

try {
  const data = JSON.parse('{name: "Sato"}'); // Error occurs
} catch (error) {
  console.error('JSON parsing error:', error.message);
}

9. JSON 可以转换为二进制格式吗？

答： 可以。BSON（Binary JSON）是一种源自 JSON 的二进制优化格式。

• 它常用于 MongoDB 等 NoSQL 数据库。
• 提供更快且更高效的数据处理。

10. 与 JSON 相关的最新趋势和技术有哪些？

答： 最近的 JSON 相关技术包括：

1. JSON‑LD： 用于 SEO 优化的结构化数据。
2. JSON5： 具备灵活语法和注释支持的扩展规范。
3. GraphQL： 以 JSON 格式交换数据的 API 设计方法。
4. 无服务器架构： 使用 AWS Lambda、Google Cloud Functions 等平台进行事件驱动的数据处理。

总结

本 FAQ 覆盖了 JSON 的基础与高级主题。虽然 JSON 简单易用，但有时需要仔细处理语法错误和扩展规范。请将本文和 FAQ 作为参考，帮助您从基础到高级应用全面掌握 JSON，并在实际项目中有效运用。