跨平台开发 / 系统课时

看懂 JSON 对象和数组结构

看懂 JSON 对象和数组结构

本篇解决 Flutter 开发中读取接口数据时无法判断 JSON 结构的问题。通过理解对象、数组、基础值与 null 的对应关系,可以准确设计 Dart 数据类型,为后续模型转换做好准备。

学习目标

  • 理解 JSON 常见数据结构及其层级关系。
  • 掌握 JSON 类型与 Dart 类型之间的映射规则。
  • 能根据接口返回内容判断模型字段设计方式。

JSON 数据的基本组成

JSON 是接口传输数据时常用的格式,它由对象、数组和基础值组成。Flutter 使用 Dart 处理 JSON 时,通常会先将 JSON 解析为 Map<String, dynamic> 或 List<dynamic>,再转换为业务模型。

一个 JSON 对象使用大括号表示,内部由键值对组成。键通常是字符串,值可以继续是对象、数组或基础类型。

json
{
  "id": 1001,
  "name": "Flutter",
  "enabled": true
}

这个对象在 Dart 中通常对应:

dart
final Map<String, dynamic> data = {
  'id': 1001,
  'name': 'Flutter',
  'enabled': true,
};

对象、数组和基础值映射

接口返回的数据结构决定了 Dart 中接收数据的类型。常见映射关系如下:

JSON 类型 示例 Dart 类型
对象 { "name": "Tom" } Map<String, dynamic>
数组 [1, 2, 3] List<dynamic>
字符串 "hello" String
数字 100 int 或 double
布尔值 true bool
空值 null null 或可空类型

实际项目中不会长期直接操作这些动态类型,而是会继续转换为强类型模型。例如用户接口可能返回:

json
{
  "id": 1,
  "username": "alice",
  "tags": ["flutter", "dart"]
}

对应的数据结构可以理解为:

dart
class User {
  final int id;
  final String username;
  final List<String> tags;

  User({
    required this.id,
    required this.username,
    required this.tags,
  });
}

嵌套结构如何判断

真实接口通常包含多层嵌套,需要先观察层级关系,再决定模型拆分方式。

例如订单接口:

json
{
  "orderId": "A001",
  "user": {
    "id": 10,
    "name": "Alice"
  },
  "items": [
    {
      "name": "Keyboard",
      "price": 99.9
    }
  ]
}

其中:

  • user 是对象,适合拆分成独立模型。
  • items 是数组,每个元素又是对象,需要设计列表模型。
  • price 是小数,应映射为 double。

遇到复杂 JSON 时,不要直接根据字段名称猜类型,而应该观察接口实际返回的数据结构。字段是否允许缺失、是否可能为 null,也会影响最终 Dart 类型设计。

null 和可空类型

JSON 中的 null 表示没有值。Dart 空安全模式下,需要使用 ? 表示字段可能为空。

例如接口可能没有返回头像:

dart
class User {
  final String name;
  final String? avatar;

  User({
    required this.name,
    this.avatar,
  });
}

如果错误地把可能为空的字段定义成非空类型,在解析阶段可能出现运行异常。

理解 JSON 结构的关键不是记忆类型转换,而是建立从接口数据到 Dart 模型的映射思维:先识别层级,再判断字段类型,最后决定模型结构。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

看懂 JSON 对象和数组结构

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通