读取NBT示例
本页面镜像自 BedrockWiki
根据原始项目协议授权。本文经过AI翻译处理，如有内容遗漏，可以提交PR进行补充。
在进行本示例前，请先系统学习NBT的完整知识体系。参考*深入理解NBT*。 现在我们将分步骤演示如何读取NBT数据，示例数据的格式如下：
json
"":{
"myText":"我的NBT文本",
"my Int32 Number":456,
}当我们不知道后续数据类型时，需要读取下一个字节。
我们读取到了数字10，表示即将读取复合标签。此时我们处于文件的根元素属性，需要读取根元素属性的名称。名称是字符串类型，因此首先需要读取字符串长度（以Int16形式存储）。
根元素属性名称的长度为0，因此无需继续读取字节。此时需要读取下一个字节来确定后续数据类型。
已知根复合标签中的下一个属性是字符串类型，但在读取属性值之前，需要先读取属性名称。因此需要再读取2个字节来获取属性名称的长度。
属性名称长度为6字节，继续读取接下来的6个字节。
通过UTF-8编码转换后，得到属性名称：myText。接下来重复字符串类型的读取流程，读取下一个Int16（2字节）来获取字符串值的长度。
字符串长度为0x0B（十进制11），继续读取11个字节。
经过UTF-8解码得到属性值：My NBT text。此时需要读取下一个字节来确定后续数据类型。
读取到类型3（Int32类型），需要先读取属性名称的长度。读取接下来的2个字节。
名称长度为0x0F（十进制15），继续读取15个字节并进行UTF-8解码。
得到属性名称：my Int32 Number。接下来读取Int32类型的4个字节。
读取到的Int32值为0x01c8（十进制456）。继续读取下一个字节确认后续数据类型。
读取到0x00空字节，表示根复合标签结束。由于这是根复合标签，此时完成整个NBT文件的读取。
NBT示例文件
本示例所使用的NBT文件：
下载NBT文件
重要注意事项
- 文件可能包含NBT基岩版文件头，需注意这种情况。参见[深入理解NBT](/wiki/nbt/nbt-in-depth)>[NBT基岩版文件头](/wiki/nbt/nbt-in-depth#bedrock-nbt-file-header)
- 结束空字节并不直接终止NBT读取，仅标记当前复合标签的结束
- 所有数值均需按小端序读取，参见[深入理解NBT](/wiki/nbt/nbt-in-depth)>[小端序](/wiki/nbt/nbt-in-depth#little-endian)
- NBT文件的首个根元素只能是复合标签或列表。根元素的名称虽然通常为空，但仍需读取并妥善处理