JSON文件解码后如何正确访问解析的嵌套结构获取指定字段值

问题核心根源 #

取值失败的本质，是把调试器的结构展示逻辑当成了代码可访问的对象属性，写的索引路径和实际嵌套结构完全不匹配。
解析完成后的真实嵌套层级如下：

• 最外层Map（共2个键值对）
  • 键message对应值：字符串"ok"
  • 键results对应值：长度为1的List集合
    • List第0个元素：Map（共4个业务字段）
      • uid："1"
      • name："TallyMini"
      • camera："2"
      • Version："0.1.0"

之前写的convertDataToJson[1]['value']['name']存在两个明显错误：

• 用数字下标1定位顶层Map的条目，完全依赖调试器的展示顺序，既不规范也容易因为条目顺序变动取错值
• 误以为调试器展示的key:"results"、value:List(1 item)是解析对象上的可访问属性，实际上这类key/value标注只是调试界面的排版格式，不是代码层面的真实成员

正确取值路径 #

按照实际嵌套逐层访问即可：

1. 通过键名从顶层Map取出results对应的List：convertDataToJson['results']
2. 从这个长度为1的List中取出下标为0的元素（即存放业务字段的Map）：convertDataToJson['results'][0]
3. 从该Map中直接取目标字段name：convertDataToJson['results'][0]['name']

修正后的代码示例 #

原本计划将name字段值加入列表的逻辑，修改后写法如下：

// 按JSON原生键路径逐层取值
final targetName = convertDataToJson['results'][0]['name'];
lst.add(targetName);

为避免JSON结构变动导致的空指针报错，建议增加简单的类型校验：

final results = convertDataToJson['results'];
if (results is List && results.isNotEmpty) {
  final itemMap = results[0];
  if (itemMap is Map && itemMap['name'] != null) {
    lst.add(itemMap['name']);
  }
}

注意事项 #

• 不要依赖调试器展示的条目序号（如p 0、p 1）做硬编码索引，这类顺序在不同解析器、不同数据场景下可能发生变化
• 取值时优先使用JSON自带的字符串键做访问，不要硬编码尝试list、value这类调试界面生成的展示字段名

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