Dart中如何像TypeScript一样定义指定键值结构的Map类型？

Dart实现固定结构键值类型校验的常用方案 #

Dart没有TypeScript那种基于对象字面量的结构化类型自动推导规则，但有两种符合Dart设计规范的原生实现方式，可完全达到和示例相同的编译期类型校验效果：

方案1：自定义类（生产环境首选，官方推荐） #

Dart最推荐用明确的类定义固定结构，类型校验在编译期完成，使用体验和TS的固定结构对象完全一致：

// 定义固定结构的类，明确每个字段的类型
class SomeStruct {
  final String a;
  final int b;

  SomeStruct({required this.a, required this.b});
}

void main() {
  // 实例化和TS对象字面量用法类似
  final someMap = SomeStruct(a: "hi", b: 3);
  // 编译期自动识别a的类型为String
  final greet = someMap.a;

  // 定义固定结构的数组
  final someMapList = <SomeStruct>[
    SomeStruct(a: "hi", b: 3),
    SomeStruct(a: "bye", b: 5),
  ];
  someMapList.map((m) {
    // 编译期直接识别m的结构，无需额外类型断言
    print("${m.a} : ${m.b}");
  });
}

该方案的优势：

• 100%编译期类型安全，无运行时类型异常风险
• 完美支持IDE智能提示、字段补全
• 可自定义扩展方法，适配复杂业务场景

方案2：Dart 3+ 记录类型（轻量场景首选） #

如果你不想单独维护类定义，Dart 3及以上版本推出的记录类型天生支持固定字段、固定类型的结构，语法更简洁：

void main() {
  // 命名记录，字段名、类型固定
  final someMap = (a: "hi", b: 3);
  // 自动推断a的类型为String
  final greet = someMap.a;

  // 定义固定结构的数组
  final someMapList = <({String a, int b})>[
    (a: "hi", b: 3),
    (a: "bye", b: 5),
  ];
  someMapList.map((m) {
    // 编译期直接识别m的结构
    print("${m.a} : ${m.b}");
  });
}

该方案的特点：

• 无需单独定义类，代码量更少
• 同样支持编译期类型校验，无额外运行时开销
• 适合临时使用的简单结构场景

如果你确实需要保留Map的访问形式，也可以通过自定义Map子类、扩展方法的方式实现固定键类型校验，但以上两种是Dart生态的标准实现，使用体验和运行效率都优于自定义Map方案。

内容的提问来源于stack exchange，提问作者Yan