Dart中Map<String,Object>类型不匹配报错及嵌套取值问题

报错原因 #

• 静态类型限制：你定义的marks变量类型为Map<String, Object>，Dart对该类型的值仅能保证为Object类型，默认没有Map的下标访问能力。如果你未做类型转换就直接对marks['Subject']执行['English']取值操作，或是误将Map类型的返回值当作String类型赋值给其他变量，就会触发你遇到的报错：The argument type 'Map<String, Object>' can't be assigned to the parameter type 'String'。
• 声明语法错误：List类型需使用方括号[]声明且仅支持存储有序元素，不支持键值对结构。如果你错误用方括号包裹Map的键值对定义变量，Dart会将该变量识别为List类型，后续执行Map的取值操作时也会触发类型不匹配问题，需先将声明符号改为用大括号{}包裹键值对。

正确取值方案 #

首先先修正变量声明的基础写法（如果存在方括号声明的错误先修复）：

// 正确的Map声明写法，使用大括号包裹键值对
final Map<String, Object> marks = {
  'Name': '测试用户',
  'Subject': {
    'Maths': 90,
    'Science': 85,
    'English': 92
  }
};

方法1：类型判断+强制转换 #

先判断取出的字段类型，避免运行时强转崩溃：

int? englishScore;
// 先校验Subject字段为Map类型
if (marks['Subject'] is Map<String, int>) {
  // 强转后取值
  final subjectMap = marks['Subject'] as Map<String, int>;
  englishScore = subjectMap['English'];
}
print(englishScore); // 输出92

方法2：使用cast方法转换类型 #

适合确认字段类型固定的场景：

final subjectMap = marks['Subject'].cast<String, int>();
final englishScore = subjectMap['English'];

方法3：定义强类型实体类（生产环境推荐） #

彻底避免动态类型带来的隐性报错：

class MarkInfo {
  final String name;
  final Map<String, int> subjectScores;

  MarkInfo({
    required this.name,
    required this.subjectScores,
  });
}

// 初始化实体
final markData = MarkInfo(
  name: '测试用户',
  subjectScores: {'Maths': 90, 'Science': 85, 'English': 92},
);
// 直接取值无需类型转换
final englishScore = markData.subjectScores['English'];

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