理解JSON¶

JSON是一种简单的文本文件格式，既易于人类理解，也易于计算机处理。基岩版使用.json文件作为附加包的“语言”，因此你需要扎实地理解如何读取和编写JSON！如果你之前从未听说过JSON，建议你阅读此教程。它将教给你编写有效JSON文件所需的所有知识。

有效的JSON¶

编写JSON时需要记住的重要一点是，它必须是完全无错误的，否则将无法正常工作。即使是一个错误的字符或一个多余的逗号也会导致整个文件失败。因此，编写有效的JSON至关重要。

我们可以使用一个名为json lint的在线工具来检查我们的JSON是否有效。只需将你的代码粘贴到网站中，然后按Validate JSON。你将收到一个响应，指示你的代码是否正确，以及任何错误的位置和类型。

数据结构¶

在JSON中，数据可以以多种格式编写。每种格式专门用于表示特定类型的数据。以下是我们可用的结构：

现在，以.json格式表示：

{
  "my_string": "hello!",
  "my_int": 15,
  "my_float": 1.2,
  "my_bool": true
}

除了这些简单的结构外，我们还有两种特殊结构。特殊结构用于嵌套其他数据。

数组¶

数组用两个方括号[]表示。它们代表一个列表。我们可以在列表中放入其他数据结构。列表中的每个元素应以逗号分隔。

一些示例：

现在，以.json格式表示：

{
   "my_ints": [1, 2, 3],
   "my_strings": ["Red", "blue"]
}

对象¶

对象用两个大括号{}表示。对象是一种特殊的语法，包含具名的数据结构。名称称为key，结构称为value。本页之前的示例是一个包含其他数据类型示例的字典。

这种键值语法的格式如下："<key>": <任何结构>。注意键周围的引号和冒号。

下面是一个对象的示例，包含几个键值对。

{
  "a_list_of_integers": [1, 2, 3],
  "is_json_cool": true
}

我们需要用逗号分隔每个键值对。

我们将对象的键值对称为其子项或称为在对象内部。

JSON结构¶

在Minecraft中，JSON文件总是以一个对象开始，你可以记住这是两个大括号{}。我们在这个对象内部编写代码，以键值对的形式表示。

以下是一个用于Minecraft附加包的简单json文件示例：

{
  "format_version": "1.12.0",
  "animations": {
    "animation.car.wheel_spin": {
      "loop": true,
      "animation_length": 1.0,
      "bones": {
        "front_wheels": {
          "rotation": ["q.modified_distance_moved * -30", 0, 0]
        },
        "back_wheels": {
          "rotation": ["q.modified_distance_moved * -30", 0, 0]
        }
      }
    }
  }
}

仔细查看格式。你会发现整个结构是由我们已经学习过的数据结构构建的。如果你想练习你的JSON技能，请尝试回答以下问题：

• 顶层对象中有多少个键？你能命名它们吗？
• format_version的值是什么？
• "loop"键中存储的数据类型是什么？（字符串、布尔值等）

故障排除示例¶

以下是一些示例，帮助你理解在Discord或在线上可能收到的反馈。我们在谈论JSON错误时往往使用技术术语，因此希望本节能帮助你熟悉这些术语：

你写道："format_version": 1.12

他们说：“format_version的值写错类型了。它应该是一个字符串。”

请记住，类型指的是结构之一：字符串、整数、浮点数、数组或对象。如果我们检查代码，会发现我们将format_version设置为了浮点数，而不是字符串。我们可以通过在"1.12"周围添加引号来解决此问题。

你写道：[1 2 5 6]

他们说：“你的数组没写逗号。”

请记住，数组元素需要用逗号分隔。你的数组应该是这样的：[1, 2, 5, 6]

他们说：“你把格式版本错放到描述内部了。它应该外放在顶层。”

这意味着"format_version"的键值对目前是描述的一个子项。你应该将键值对从描述对象中复制/粘贴出来，并放置在顶层。