1. 从一次数据解析的“翻车”说起为什么遍历JSON不是小事那天下午我正处理一个从第三方API拉取的用户行为数据流。数据是标准的JSON格式看起来人畜无害。我的任务很简单遍历这个嵌套了四五层的JSON对象提取出每个用户的最后操作时间戳。我随手写了个for key, value in data.items():心想这还不是分分钟的事。结果程序跑起来日志里疯狂报错TypeError: ‘int‘ object is not iterable。我愣住了对着屏幕看了半天才反应过来——JSON里不光有字典还有列表、字符串、数字甚至布尔值和null。我那“万能”的items()方法遇到列表直接就歇菜了。这个跟头摔得我有点懵也让我彻底明白在Python里处理JSON遍历键值对远不是调用一个方法那么简单。它像是一次深入数据结构的探险你需要根据地形数据类型随时切换工具。网上很多教程只告诉你json.loads()和json.dumps()仿佛这就是全部但真正让数据“活”起来、能被你随心所欲使用的恰恰是遍历这个环节。无论是分析日志、配置应用还是清洗爬虫数据你几乎每天都在和JSON的遍历打交道。搞不定它数据就只是一堆僵死的文本搞定了你才能提取洞察、驱动业务。所以今天我们不聊那些浮于表面的语法就扎扎实实地把Python中遍历JSON数据的所有门道一次捋清。从最基础的字典遍历到处理令人头疼的嵌套结构再到如何优雅地应对那些意料之外的数据类型。我会把当年踩过的坑、总结出的“心法”以及那些官方文档里不会写的细节都摊开来跟你讲明白。无论你是刚接触Python和数据还是已经写过不少脚本但总觉得处理JSON不够利索这篇内容都能让你有实实在在的收获。2. 基石理解Python中的JSON与数据类型映射在动手遍历之前我们必须先达成一个共识在Python的世界里“JSON数据”和“Python对象”是两套不同的表述但它们之间有一条非常清晰的双向转换通道。json模块的核心工作就是担任这两者之间的翻译官。当你用json.loads()读入一个JSON字符串或者用json.load()读入一个JSON文件时这个翻译官就开始工作了。它会严格按照下面的对照表进行转换JSON 数据类型Python 数据类型关键特性与遍历影响对象 (Object)字典 (dict)这是键值对遍历的核心。拥有items(),keys(),values()等方法。数组 (Array)列表 (list)这是遍历中主要的“陷阱”来源。列表没有键只有索引和值。字符串 (String)字符串 (str)可迭代但迭代的是单个字符通常这不是我们遍历JSON的目的。数字 (Number)整数 (int) 或 浮点数 (float)不可迭代。试图遍历会直接引发TypeError。布尔值 (Boolean)布尔值 (bool)不可迭代。空值 (null)None不可迭代。这个映射关系是遍历操作的绝对前提。你写的每一行遍历代码实际上都是在和这些转换后的Python对象打交道。很多初学者遇到的第一个困惑就是“我明明读的是JSON为什么代码里用的是字典的方法” 现在你知道了因为JSON对象在Python里就是字典。这里有一个至关重要的细节JSON标准要求对象的键必须是字符串。这意味着当你把Python字典转换成JSON时所有非字符串的键比如数字、元组都会被强制转换成字符串。反过来从JSON读回Python时字典的键也一定是字符串。这一点保证了遍历时键的类型是稳定的你不需要担心键是整数还是其他什么类型。注意虽然JSON键是字符串但在Python中访问字典时你必须使用字符串形式的键。例如JSON中是{1: value}在Python中你必须用data[1]来访问而不是data[1]。理解了这个映射我们就能看清遍历的本质遍历JSON就是在遍历一个可能由字典、列表、字符串、数字等混合构成的Python数据结构。我们的策略必须能智能地分辨当前正在处理的是什么“地形”并选用正确的“行进方式”。3. 核心武器库字典(dict)的三种遍历范式既然JSON对象对应Python字典那么遍历字典就是我们的基本功。Python为字典提供了三种清晰、高效的遍历方式它们各有最佳的使用场景。3.1 同时获取键与值items()方法最常用这是你在99%的场景下应该首先想到的方法。它返回一个视图对象包含字典中所有的(键, 值)对。import json json_str ‘{name: Alice, age: 30, city: New York}‘ data json.loads(json_str) for key, value in data.items(): print(fKey: {key}, Value: {value}, Type of Value: {type(value)})输出Key: name, Value: Alice, Type of Value: class ‘str‘ Key: age, Value: 30, Type of Value: class ‘int‘ Key: city, Value: New York, Type of Value: class ‘str‘为什么它最常用因为在数据处理时我们通常既需要键知道这个数据是什么也需要值数据的内容。items()一次性给你两个变量代码最简洁意图最清晰。它也是后续我们处理嵌套结构时递归遍历的基石。实操心得在Python 3中items()返回的是“视图”它非常高效几乎不占用额外内存并且会实时反映字典的变化。如果你需要一份固定的快照例如在遍历过程中可能修改原字典可以将其转换为列表list(data.items())。3.2 仅需键或仅需值keys()与values()有些时候你的目标很单纯。场景一只想检查或处理所有的键。比如验证JSON的格式是否符合预期或者过滤出包含特定前缀的键。for key in data.keys(): if key.startswith(‘user_‘): print(fFound user-related key: {key})场景二只想聚合或分析所有的值。比如计算所有数值型值的总和或平均值。total 0 count 0 for value in data.values(): if isinstance(value, (int, float)): total value count 1 if count 0: print(fAverage of numeric values: {total / count})keys()和values()同样返回视图对象具有高效的特点。但根据我的经验直接使用items()然后在循环体内按需使用key或value往往比分开调用keys()和values()更灵活也更容易避免后续需要另一个时再去字典里查找的性能损耗。除非你的逻辑明确只关心一方否则items()是更通用的选择。3.3 顺序问题遍历时键的顺序有保障吗这是一个经典的面试题也是实际开发中容易踩坑的地方。在Python 3.7及以上版本中字典会保持元素的插入顺序。这意味着当你用json.loads()加载一个JSON字符串时字典中键值对的顺序与它们在JSON字符串中出现的顺序是一致的。但是请注意两个重要的边界条件Python 3.6及以前字典的遍历顺序是未定义的它可能因Python解释器版本、甚至每次运行而异。如果你写的代码需要兼容旧版本绝不能依赖遍历顺序。编程规范即使在新版本中顺序有保障从逻辑严谨性上讲JSON对象本身在标准定义中就是“无序的键值对集合”。如果你的业务逻辑强烈依赖于某个顺序例如配置文件中的段落顺序更好的做法是使用JSON数组对应Python列表或者在数据设计时就为键添加明确的顺序标识字段。我的建议对于Python 3.7的项目你可以放心地认为遍历顺序就是加载时的顺序这在处理配置文件或需要保持输出格式时非常有用。但对于核心的业务逻辑尽量设计成不依赖顺序的这样代码的健壮性会更强。4. 进阶挑战征服嵌套与混合数据结构真实的JSON数据很少是扁平的一层。它常常是字典套列表、列表套字典层层嵌套像一座迷宫。这才是遍历操作真正的挑战所在。我们需要一套系统性的方法来探索这座迷宫。4.1 递归遍历解开嵌套结构的万能钥匙递归是处理嵌套结构的天然工具。其核心思想是定义一个函数它能够处理当前层级的数据。如果遇到的值是一个字典就递归调用自身去遍历这个字典如果遇到的值是一个列表就遍历这个列表并对列表中的每一个元素递归调用自身。下面是一个经典的递归遍历函数它会打印出JSON结构中所有的路径和对应的值def traverse_json(data, parent_path‘‘): 递归遍历JSON数据Python对象。 :param data: 当前要遍历的数据节点 :param parent_path: 当前节点的路径前缀 if isinstance(data, dict): # 当前节点是字典遍历其键值对 for key, value in data.items(): # 构建当前路径 current_path f{parent_path}.{key} if parent_path else key print(fPath: {current_path}) # 递归处理值 traverse_json(value, current_path) elif isinstance(data, list): # 当前节点是列表遍历其索引和元素 for index, item in enumerate(data): current_path f{parent_path}[{index}] print(fPath: {current_path} (List Item)) # 递归处理列表项 traverse_json(item, current_path) else: # 当前节点是叶子节点字符串、数字、布尔值、None current_path parent_path print(fPath: {current_path} - Value: {data} (Type: {type(data).__name__})) # 示例一个嵌套的JSON complex_json { “name”: “Project”, “status”: True, “config”: { “threshold”: 0.8, “filters”: [“active”, “verified”] }, “members”: [ {“id”: 1, “role”: “admin”}, {“id”: 2, “role”: “user”} ] } traverse_json(complex_json)这个函数会输出从根到每一个叶子节点的完整路径让你对数据结构一目了然。递归的强大之处在于无论数据嵌套多深代码逻辑都保持不变。避坑指南递归最大的风险是深度过深导致“递归错误”RecursionError。Python默认的递归深度限制在1000层左右。对于极端深度的JSON虽然不常见你需要考虑使用迭代栈的方式或者手动设置递归深度sys.setrecursionlimit()。但在99.9%的Web API或配置JSON场景下递归深度完全够用。4.2 迭代遍历栈另一种清晰的思路如果你对递归感到不放心或者想更显式地控制遍历过程使用栈Stack进行深度优先搜索DFS是一个很好的选择。其原理是把待处理的节点压入栈中循环处理直到栈空。def traverse_json_with_stack(data): 使用栈迭代来遍历JSON数据。 stack [(data, ‘‘)] # 栈中元素为 (节点数据, 路径) while stack: current_data, current_path stack.pop() # 弹出栈顶元素 if isinstance(current_data, dict): for key, value in current_data.items(): new_path f{current_path}.{key} if current_path else key stack.append((value, new_path)) # 将子节点压栈 elif isinstance(current_data, list): for index, item in enumerate(reversed(current_data)): # reversed保证顺序 new_path f{current_path}[{index}] stack.append((item, new_path)) else: print(fPath: {current_path} - Value: {current_data})迭代法的优势是完全没有递归深度的限制并且每一步的状态都清晰可见。代码稍长但对于理解遍历过程非常有帮助。4.3 实战场景搜索、过滤与修改掌握了遍历方法我们就能解决实际问题了。下面看几个常见场景。场景一搜索特定键假设我们要在一个深嵌套的JSON中找到所有名为“email“的字段。def find_keys(data, target_key): results [] def _traverse(node, path): if isinstance(node, dict): for key, value in node.items(): new_path f{path}.{key} if path else key if key target_key: results.append((new_path, value)) _traverse(value, new_path) elif isinstance(node, list): for i, item in enumerate(node): _traverse(item, f{path}[{i}]) _traverse(data, ‘‘) return results emails find_keys(complex_json, “email“)场景二修改特定值将嵌套结构中所有值为“active“的字符串改为“enabled“。def modify_values(data, old_val, new_val): if isinstance(data, dict): for key in data: if data[key] old_val: data[key] new_val else: # 递归修改子对象 modify_values(data[key], old_val, new_val) elif isinstance(data, list): for i in range(len(data)): if data[i] old_val: data[i] new_val else: modify_values(data[i], old_val, new_val) # 对于非容器类型函数直接结束场景三条件过滤提取从一个用户列表中提取出所有年龄大于25岁的用户信息。user_list_json ‘[{name: “Alice“, “age“: 30}, {name: “Bob“, “age“: 22}, {name: “Charlie“, “age“: 28}]‘ users json.loads(user_list_json) # users 是一个列表 adult_users [] for user in users: # 直接遍历列表 if isinstance(user, dict) and user.get(“age“, 0) 25: adult_users.append(user) print(json.dumps(adult_users, indent2))在这些场景中递归或迭代的遍历框架是固定的你只需要在框架内插入自己的业务判断逻辑if条件和操作逻辑修改、添加等即可。5. 避坑指南遍历中的七个典型“雷区”与解决方案即使知道了方法在实际编码中依然会遇到各种意想不到的问题。下面是我总结的七个最常见“坑点”及其解决方案。5.1 雷区一误将列表当字典遍历这是开篇提到的那个错误。JSON数组对应Python列表列表没有items()方法。data json.loads(‘[“a“, “b“, “c“]‘) # data 是一个列表 # 错误做法 # for k, v in data.items(): # AttributeError: ‘list‘ object has no attribute ‘items‘ # 正确做法 for item in data: print(item)解决方案在遍历前先用isinstance()判断数据类型。if isinstance(data, dict): # 按字典方式遍历 elif isinstance(data, list): # 按列表方式遍历 else: # 处理叶子节点5.2 雷区二遍历时修改字典大小在遍历字典的同时直接增删字典的键会导致运行时错误或不可预知的行为。data {“a“: 1, “b“: 2, “c“: 3} # 危险可能在遍历中途出错 for key in data: if key “b“: del data[key] # RuntimeError: dictionary changed size during iteration解决方案如果需要修改先记录下要操作的键遍历结束后再处理。keys_to_delete [] for key in data: if key “b“: keys_to_delete.append(key) for key in keys_to_delete: del data[key]或者遍历字典的键的副本for key in list(data.keys()): # 注意这里用了list()创建副本 if key “b“: del data[key]5.3 雷区三忽略值的类型导致操作错误你试图对一个可能是字符串也可能是数字的值进行算术运算。value data.get(“some_key“) result value 10 # 如果value是字符串”5“这里会TypeError解决方案进行类型检查或转换。value data.get(“some_key“) if isinstance(value, (int, float)): result value 10 elif isinstance(value, str) and value.isdigit(): result int(value) 10 else: result None # 或进行其他错误处理5.4 雷区四路径拼接错误在递归构建路径时对于根节点、字典键、列表索引的拼接处理不当可能导致路径字符串出现多余的.或[]。# 不完善的路径拼接逻辑 def build_path(old_path, new_part): return old_path “.“ new_part # 如果old_path为空会得到”.key“解决方案使用条件判断来优雅地拼接。def build_path(old_path, new_part): if not old_path: return new_part else: # 判断new_part是字典键如“name”还是列表索引如“[0]” if new_part.startswith(‘[‘): # 列表索引直接拼接 return old_path new_part else: # 字典键前加“.” return old_path ‘.‘ new_part5.5 雷区五循环引用导致递归无限循环如果JSON数据在Python中存在循环引用递归函数会陷入无限循环直到崩溃。虽然纯JSON字符串不可能有循环引用但你的Python对象在经过一些操作后可能会产生。a {} b {“ref“: a} a[“ref“] b # 循环引用 # traverse_json(a) # 这将无限递归解决方案对于可能处理任意Python对象的通用遍历器需要记录已访问过的对象ID。def safe_traverse(data, parent_path‘‘, visitedNone): if visited is None: visited set() # 获取对象的唯一ID内存地址 obj_id id(data) if obj_id in visited: print(f”Path: {parent_path} - [Cyclic Reference Detected]“) return visited.add(obj_id) # ... 原有的遍历逻辑 ... # 在递归调用时将visited集合传递下去 # ... visited.remove(obj_id) # 可选严格来说对于树状结构不需要但有助于理解5.6 雷区六编码问题导致键名错误当JSON中包含非ASCII字符如中文作为键名时如果编码处理不当在遍历或打印时可能会出现乱码。# 假设从文件读取文件编码是utf-8 with open(‘data.json‘, ‘r‘, encoding‘utf-8‘) as f: data json.load(f) # json.load 会自动处理编码 # 此时data中的中文字符串是正常的Python str遍历无问题。解决方案确保在读取和写入时都明确指定正确的编码通常是utf-8。json.load()/json.loads()本身能正确处理Unicode问题通常出在文件打开或网络传输的环节。5.7 雷区七超大JSON文件的内存瓶颈使用json.load()一次性将整个超大JSON文件读入内存可能导致内存耗尽。解决方案使用流式解析。ijson是一个优秀的第三方库它可以像解析XML的SAX模式一样流式地读取JSON文件无需全部加载。import ijson with open(‘huge_file.json‘, ‘rb‘) as f: # 注意是‘rb‘二进制模式 # 流式遍历顶级对象中的“items”数组 for item in ijson.items(f, ‘items.item‘): process_item(item) # 每次只处理一个item内存友好对于特别大的文件这是唯一的可行方案。当然这要求你的JSON结构相对规整并且你知道需要提取的数据路径。6. 性能优化与最佳实践当数据量变大或者遍历操作非常频繁时性能就需要被考虑进来。这里有一些提升效率的技巧。6.1 选择高效的遍历方式直接迭代 vskeys()/values()/items()在Python 3中for key in data:、for value in data.values():和for key, value in data.items():的性能差异极小因为它们都是返回视图。选择哪种取决于你的需求可读性优先。避免在循环内重复查找这是一个常见的微优化点。# 欠佳每次循环都查找两次 for key in data: if key in data and data[key] threshold: # 这里key in data是多余的因为key来自data本身 process(data[key]) # 更佳使用items() for key, value in data.items(): if value threshold: process(value)6.2 利用生成器处理大型结构如果你遍历的目的是为了查找或过滤出某些结果并可能提前终止使用生成器函数可以节省内存。def find_large_numbers(data, threshold): 生成器递归地找出所有大于阈值的数值。 if isinstance(data, dict): for value in data.values(): yield from find_large_numbers(value, threshold) elif isinstance(data, list): for item in data: yield from find_large_numbers(item, threshold) elif isinstance(data, (int, float)) and data threshold: yield data # 使用 for num in find_large_numbers(complex_json, 10): print(num) # 如果找到第一个满足条件的就退出生成器不会计算后续所有结果 break6.3 最佳实践总结防御性编程始终使用isinstance()进行类型检查尤其是在处理来源不可信的JSON数据时。明确你的目标在开始写遍历代码前想清楚你到底要什么。是修改数据收集信息还是验证结构不同的目标可能对应不同的最优遍历策略。善用get()方法访问字典键时使用data.get(‘key‘)而不是data[‘key‘]可以避免KeyError并提供默认值data.get(‘key‘, default)。保持代码清晰复杂的遍历逻辑封装成函数。给函数和变量起有意义的名字比如extract_user_emails比traverse_json更能表达意图。编写单元测试对于复杂的JSON遍历逻辑用几个具有代表性的、边界情况的JSON样例进行测试确保你的代码健壮可靠。遍历JSON键值对从表面看是语法问题深入看是数据结构问题最终是逻辑思维问题。它要求你对数据形态有清晰的预判对程序流程有严谨的控制。掌握了从基础遍历到递归处理再到避坑和优化的全套方法你就能在面对任何复杂的JSON数据时都像拥有一张清晰的地图从容不迫地提取出你需要的信息。下次再遇到JSON希望你的第一反应不再是搜索“如何遍历”而是自信地写下最合适的那几行代码。