BE教程

附加包教程第四期——了解JSON

7***Lv.3 中级会员发表于 2022-5-1 · 最后回复 2022-10-3 IP:江苏省 4,376 2

AI 速览2026-10-01 22:27 生成

附加包教程第四期讲解 JSON 语法、数据类型与常见错误

这是附加包教程系列的第四期，专门介绍 JSON 这种数据格式。帖子从 JSON 的定义讲起，依次说明字符串、整数、浮点数、布尔值、数组和对象等数据类型，并给出完整结构示例与解析，最后提醒编写时容易出现的逗号、引号、数据类型错误。适合正在学习我的世界附加包、需要打牢 JSON 基础的新手阅读。

论坛附件

demo_JSON.json469 B

获取方式

论坛附件 demo_JSON.json，469 B，免费，为帖中示例文件

JSON 文件语法严格，多一个逗号或少一个引号都可能导致整个文件失效
部分数据类型错误电脑检查不出来，需要人工核对
帖中建议不要完全依赖在线检查工具

本卡片由 AI 阅读本帖后生成，可能存在疏漏，请以帖子正文为准。

本帖最后由 782 于 2022-7-30 11:10 编辑

了解JSON

一、什么是JSON？

JSON 指的是 JavaScript 对象表示法（JavaScript Object Notation）
JSON 是轻量级的文本数据交换格式
JSON 具有自我描述性，更易理解

（摘自这里）
JSON就是一种简单的“语言”，它可以让计算机快速读取数据，以快速响应。我的世界的附加包也正是运用了这个原理。
我们之前在这里认识过JSON，不过没有细讲，今天单独讲

二、JSON的数据类型
基础类型：

类型名称	示例	解释
字符串(String)	"你好Hello!"	可以是任意字符（如字母、汉字、符号等）不要忘记双引号(" ")
整数(Int)	4	一个整数
浮点数(Float)	4.78	一个小数
布尔值(Bool)	true	表示真或假，仅有true(真)或false(假)

数组(Array)
数组被中括号( [ ] )包括，表示一个列表，并且数组内的项目要用英文逗号( , )隔开
注意不要忘记逗号( , )

示例	意义
[1, 2, 3]	一个整数列表
["你好", "Hello", "!!!"]	一个字符串列表

对象
对象被大括号( { } )包括，
对象有独特的语法：<键(key)>: <值(value)>
键应为字符串，值可以是任何合法数据
注意不要忘记冒号( : )和逗号( , )
示例：

{
"type": "resources",
"format_version": 2
}

复制代码

这里的逗号( , )用于分隔键值对（每组键和值）

三、JSON完整结构示例与解析

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

复制代码

在我的世界中，JSON文件大部分以一个对象开头，可以记住它有两个大括号：{}。我们称之为根对象。我们以键值对的形式在这个对象中编写代码。
仔细观察这个例子，你就会发现这个文件里面的数据都是上文提到过的。

三、编写正确的JSON文件
1. 防止粗心
JSON文件是严格的，如果你的JSON文件里多了一个逗号，或少了一个引号，可能就会使整个文件全部失效。
所以，我们一定要细心，编写的时候注意语法，写完之后最好检查一遍，保证万无一失。
这个网站可以帮你检查JSON文件：https://jsonlint.com/，
但是你不能依赖于这样的网站，因为还有一些错误是人工才能检查出来的。

2.使用正确的数据类型
编写代码的时候，还可能会写错数据类型，例如把"format_version": "1.12.0"写成"format_version": 1.12，把"loop": true写成"loop": "true"等。
一般这种错误电脑检查不出来，需要人工检查才行。