Python中高效访问JSON嵌套列表字典数据的技巧-Python教程-PHP中文网

Python中高效访问JSON嵌套列表字典数据的技巧

DDD

发布： 2025-08-15 23:28:32

原创

750人浏览过

python中高效访问json嵌套列表字典数据的技巧

本文旨在教授如何在Python中有效地解析和访问复杂JSON结构中深度嵌套的列表和字典数据。通过理解JSON的层级关系，并结合正确的列表索引和字典键访问方法，您可以精准地提取所需的数据，无论是通过直接路径访问还是通过迭代遍历动态数据。

JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，在现代Web应用和数据处理中无处不在。然而，其灵活性也带来了在处理复杂、深度嵌套的数据结构时的一些挑战，尤其当数据中混合了列表（数组）和字典（对象）时。本教程将深入探讨如何精确地从这种复杂结构中提取特定值。

理解JSON数据结构

在尝试访问任何JSON数据之前，最关键的一步是彻底理解其内部结构。JSON数据由两种基本结构组成：

对象（Object）：由键值对组成，对应Python中的字典（dict）。用花括号 {} 表示。
数组（Array）：有序的值的集合，对应Python中的列表（list）。用方括号 [] 表示。

理解这种结构是构建正确访问路径的基础。例如，如果一个键的值是 [...]，则它是一个列表，需要通过索引（如 [0]）来访问其元素；如果一个键的值是 {...}，则它是一个字典，需要通过键名（如 ["key"]）来访问其内部数据。

考虑以下示例JSON片段，它展示了一个典型的嵌套结构：

立即学习“Python免费学习笔记（深入）”；

{
  "liveData": {
    "plays": {
      "allPlays": [
        {
          "runners": [
            {
              "details": {
                "event": "Single",
                "runner": {
                  "id": 656941,
                  "fullName": "Kyle Schwarber"
                },
                "responsiblePitcher": null,
                "isScoringEvent": false,
                "rbi": false,
                "earned": false,
                "teamUnearned": false,
                "playIndex": 6
              }
            }
          ]
        }
      ]
    }
  }
}

登录后复制

我们的目标是从这个结构中提取 id 的值（例如 656941）。

逐层深入访问数据

要访问深度嵌套的值，我们需要沿着数据路径一步步地深入。每遇到一个字典，就使用其键来访问；每遇到一个列表，就使用其索引来访问。

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

首先，我们需要将JSON字符串加载为Python对象：

import json

json_data_str = """
{
  "liveData": {
    "plays": {
      "allPlays": [
        {
          "runners": [
            {
              "details": {
                "event": "Single",
                "runner": {
                  "id": 656941,
                  "fullName": "Kyle Schwarber"
                },
                "responsiblePitcher": null,
                "isScoringEvent": false,
                "rbi": false,
                "earned": false,
                "teamUnearned": false,
                "playIndex": 6
              }
            }
          ]
        }
      ]
    }
  }
}
"""

data = json.loads(json_data_str)

登录后复制

现在，我们来分析并构建访问 id 的路径：

从根字典 data 开始，通过键 liveData 访问到下一层字典：data["liveData"]。
接着通过键 plays 访问：data["liveData"]["plays"]。
再通过键 allPlays 访问：data["liveData"]["plays"]["allPlays"]。此时，我们得到一个列表。
由于 allPlays 是一个列表，我们需要指定列表中的元素。如果我们知道 id 位于第一个元素中，可以使用索引 [0]：data["liveData"]["plays"]["allPlays"][0]。此时，我们得到一个字典。
在这个字典中，通过键 runners 访问：data["liveData"]["plays"]["allPlays"][0]["runners"]。此时，我们再次得到一个列表。
同样，如果 id 位于 runners 列表的第一个元素中，使用索引 [0]：data["liveData"]["plays"]["allPlays"][0]["runners"][0]。此时，我们得到一个字典。
在这个字典中，通过键 details 访问：data["liveData"]["plays"]["allPlays"][0]["runners"][0]["details"]。此时，我们得到一个字典。
最后，通过键 runner 访问，再通过 id 访问：data["liveData"]["plays"]["allPlays"][0]["runners"][0]["details"]["runner"]["id"]。

完整的直接访问代码如下：

id_value = data["liveData"]["plays"]["allPlays"][0]["runners"][0]["details"]["runner"]["id"]
print("提取到的ID值:", id_value)

登录后复制

迭代遍历动态数据

在实际应用中，allPlays 或 runners 列表可能包含多个元素，并且我们可能需要提取所有符合条件的 id 值。这时，简单的直接索引 [0] 就不适用了，我们需要使用循环进行迭代。为了提高代码的健壮性，我们还会加入键和类型的检查。

all_ids = []

# 遍历 allPlays 列表中的每一个 play
# 检查 'allPlays' 键是否存在且其值是否为列表
if "liveData" in data and \
   "plays" in data["liveData"] and \
   "allPlays" in data["liveData"]["plays"] and \
   isinstance(data["liveData"]["plays"]["allPlays"], list):

    for play in data["liveData"]["plays"]["allPlays"]:
        # 检查 play 中是否存在 'runners' 键且其值为列表
        if "runners" in play and isinstance(play["runners"], list):
            # 遍历 runners 列表中的每一个 runner_info
            for runner_info in play["runners"]:
                # 检查 runner_info 中是否存在 'details' 键且其值为字典
                if "details" in runner_info and isinstance(runner_info["details"], dict):
                    details = runner_info["details"]
                    # 检查 details 中是否存在 'runner' 键且其值为字典
                    if "runner" in details and isinstance(details["runner"], dict):
                        runner = details["runner"]
                        # 检查 runner 中是否存在 'id' 键
                        if "id" in runner:
                            all_ids.append(runner["id"])

print("所有提取到的ID值:", all_ids)

登录后复制

上述代码通过多层嵌套循环，确保了即使在数据结构中存在多个 play 或多个 runner 的情况下，也能正确地提取所有 id 值。同时，加入了 in 关键字和 isinstance 函数进行键和类型检查，增强了代码的健壮性，避免在数据结构不完全符合预期时引发 KeyError 或 TypeError。

注意事项

键错误 (KeyError)：当你尝试访问一个字典中不存在的键时，Python会抛出 KeyError。在处理来自外部源的JSON数据时，数据结构可能不总是完全一致，因此建议使用 dict.get() 方法或者 try-except 块来安全地访问可能不存在的键。例如：play.get("runners")。
索引越界 (IndexError)：当你尝试访问列表中不存在的索引时，Python会抛出 IndexError。在迭代列表之前，最好检查列表是否为空，或者确保索引在有效范围内。
数据类型检查：在访问嵌套数据时，确认当前层级的数据类型（是列表还是字典）至关重要。使用 isinstance() 函数可以有效地进行类型检查，如 isinstance(data_item, dict) 或 isinstance(data_item, list)。
可读性与模块化：对于极其复杂的JSON结构，可以将数据提取逻辑封装到函数中，提高代码的可读性和可维护性。
使用工具：对于非常庞大或结构异常复杂的JSON文件，可以使用在线JSON查看器或Python库（如 jsonpath-rw）来辅助理解和查询数据。

总结

高效访问JSON中嵌套的列表和字典数据，核心在于精确地理解JSON的层级结构，并正确地运用Python中字典的键访问 ([] 或 .get()) 和列表的索引访问 ([])。对于静态或已知结构的数据，可以直接构建访问路径；而对于动态或包含多个元素的列表，则需要结合循环和条件判断来迭代遍历，并增强代码的健壮性以处理可能缺失的键或空列表。掌握这些技巧，将使您在处理各种JSON数据时游刃有余。

以上就是Python中高效访问JSON嵌套列表字典数据的技巧的详细内容，更多请关注php中文网其它相关文章！