理解JSON

有效的JSON
数据结构
- 数组
- 对象
JSON结构
故障排除示例

TIP

这是附录页面。您可以从头开始阅读指南这里。

JSON是一种简单的文本文件格式，人类和计算机都能理解。基岩版使用.json文件作为附加组件的"语言"，因此您需要扎实掌握如何读写JSON！如果您从未接触过JSON，建议您阅读这篇教程。它将教会您编写有效JSON文件所需的一切知识。

有效的JSON

编写JSON时最重要的是必须_完全无错误_，否则整个文件都将失效。即使是一个错误的字符或多余逗号也会导致整个文件失败。因此，编写有效的JSON至关重要。

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

数据结构

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

名称	示例	说明
字符串	"你好！"	单词或字符。需要引号。
整数	15	数字。不需要引号。
浮点数	1.2	小数。不需要引号。
布尔值	true	只能是true或false。不需要引号。

以.json格式表示：

json

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

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

数组

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

一些示例：

结构	说明
[1, 2, 3]	整数列表。
["红", "蓝"]	字符串列表。注意引号！

以.json格式表示：

json

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

对象

对象用两个花括号{}表示。对象是一种特殊语法，包含_命名的_数据结构。名称称为键，结构称为值。本页前面的示例是一个_字典_，包含其他数据类型的示例。

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

以下是一个对象的示例，其中包含几个_键值对_。

json

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

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

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

JSON结构

在Minecraft中，JSON文件总是以一个_对象_开头，您可以记住这是两个花括号：{}。我们称之为_顶层对象_。我们以键值对的形式在这个对象_内部_编写代码。

以下是一个简单的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]
                }
            }
        }
    }
}