跨平台开发 / 系统课时
使用 Map 组织键值数据
使用 Map 组织键值数据
当数据天然由“键”定位“值”时,Map 比并行列表更直接。本篇会用一个库存索引完成创建、读取、更新、删除、遍历与缺失键处理,并说明类型声明和 null 语义中最容易踩到的边界。
学习目标
- 创建键和值类型明确的
Map,并用键完成常见增删改查。 - 使用
containsKey、entries和空值运算符安全处理缺失键。 - 判断
Map适合配置、索引和结构化对象数据的场景。
创建并按键读取数据
Map<K, V> 用键类型 K 和值类型 V 描述数据约束。键应能稳定代表一条数据,例如商品 SKU、用户 ID 或配置项名称;值则保存与该键关联的信息。
下面的字面量明确声明为 Map<String, int>,因此键只能是字符串,值只能是整数。通过 map[key] 读取时,返回类型是可空的 V?,因为目标键可能不存在。
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}');
}
}预期输出
A-100=12
C-300 before insert=0
has B-200=true
removed A-100=12
B-200:8
C-300:3Map 的方括号读取不会因为键不存在而抛出异常,而是返回 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 能让结构和意图保持一致;同时配合明确的泛型类型与缺失键策略,可避免大量运行时类型判断和空值分支。