跨平台开发 / 系统课时

使用 Map 组织键值数据

使用 Map 组织键值数据

当数据天然由“键”定位“值”时,Map 比并行列表更直接。本篇会用一个库存索引完成创建、读取、更新、删除、遍历与缺失键处理,并说明类型声明和 null 语义中最容易踩到的边界。

学习目标

  • 创建键和值类型明确的 Map,并用键完成常见增删改查。
  • 使用 containsKey、entries 和空值运算符安全处理缺失键。
  • 判断 Map 适合配置、索引和结构化对象数据的场景。

创建并按键读取数据

Map<K, V> 用键类型 K 和值类型 V 描述数据约束。键应能稳定代表一条数据,例如商品 SKU、用户 ID 或配置项名称;值则保存与该键关联的信息。

下面的字面量明确声明为 Map<String, int>,因此键只能是字符串,值只能是整数。通过 map[key] 读取时,返回类型是可空的 V?,因为目标键可能不存在。

dart
void main() {
  final Map<String, int> stockBySku = {
    'A-100': 12,
    'B-200': 5,
  };

  // 缺失键会得到 null,这里用 ?? 提供业务默认值。
  final aStock = stockBySku['A-100'];
  final missingStock = stockBySku['C-300'] ?? 0;

  // 赋值既能覆盖已有键,也能新增键。
  stockBySku['B-200'] = 8;
  stockBySku['C-300'] = 3;

  print('A-100=$aStock');
  print('C-300 before insert=$missingStock');
  print('has B-200=${stockBySku.containsKey('B-200')}');

  final removed = stockBySku.remove('A-100');
  print('removed A-100=$removed');

  for (final entry in stockBySku.entries) {
    print('${entry.key}:${entry.value}');
  }
}

预期输出

text
A-100=12
C-300 before insert=0
has B-200=true
removed A-100=12
B-200:8
C-300:3

Map 的方括号读取不会因为键不存在而抛出异常,而是返回 null。因此如果业务上允许缺省值,可使用 ??;如果必须区分“键不存在”和“键存在但值就是 null”,则应调用 containsKey。

写入、删除与检查键

执行 map[key] = value 时,已有键会被更新,不存在的键会被加入。remove(key) 会删除该键,并返回原值;若键不存在则返回 null。需要在“不存在时才创建”时,还可以使用 putIfAbsent,避免先检查再写入的重复逻辑。

判断键是否存在应优先使用 containsKey,判断某个值是否出现则使用 containsValue。两者表达的意图不同,不要用 map[key] != null 代替键存在检查,因为当值类型本身允许 null 时会产生歧义。

遍历键值对

只关心键时使用 keys,只关心值时使用 values;需要同时得到两者时,遍历 entries 最清晰。每个 MapEntry 都提供 key 和 value,适合生成列表、序列化对象或把索引转换成展示数据。

Dart 常见的字面量 Map 会保留插入顺序,但业务逻辑不应把“顺序”当成键值映射的核心含义。若真正需要按数值位置访问数据,应使用 List;若只需要保证元素唯一而不需要键值对应,则 Set 更合适。

选择合适的缺失键策略

缺失键没有唯一处理方式,应由业务语义决定:配置项可回退到默认值,索引查询可能需要返回 null,而必须存在的字段则应在读取后主动校验并抛出明确错误。关键是不要让“键缺失”悄悄变成错误的默认数据。

当键能够稳定标识数据、读取动作以“给定键找到值”为主时,Map 能让结构和意图保持一致;同时配合明确的泛型类型与缺失键策略,可避免大量运行时类型判断和空值分支。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Map 组织键值数据

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

登录哪都通