Python字典怎么遍历?获取键、值及键值对的方法
详细介绍Python中遍历字典的三种主要方法,包括遍历键(keys)、遍历值(values)以及遍历键值对(items),并深入解析元组解包机制、按需排序及避免RuntimeError的进阶技巧与选型指南。
在开发 Web 服务、解析接口响应或读取本地配置文件时,我们经常需要处理包含多种参数的 Python 字典。例如从用户配置字典中提取所有开关名称、统计数值型数据的总和,或者将所有配置项逐行打印到日志中。这些需求的核心都是遍历字典。Python 为字典提供了三种原生视图方法及直接迭代机制,分别对应获取“键(Keys)”、“值(Values)”以及“键值对(Items)”。本文将直接梳理这几种遍历方法的具体语法、执行原理、注意事项与适用场景。
一、遍历字典的键(Keys)
当只需要使用字典的索引名称,或者需要根据键名做条件判断时,获取全部键是最基本的操作。Python 提供了两种主要方式来遍历字典的键:默认迭代与显式调用 keys()。
1. 直接遍历字典(推荐写法)
在 Python 中,字典本身是一个可迭代对象,其默认迭代的行为就是产出它的键。这是官方推荐且最为简洁的 Pythonic 写法:
user_profile = {
"username": "alex_dev",
"role": "engineer",
"status": "active"
}
# 直接遍历字典,默认获得每一个键
for key in user_profile:
print(f"键名: {key}")
示例输出:
键名: username
键名: role
键名: status
2. 显式调用 keys() 方法
也可以使用 user_profile.keys() 显式返回键视图对象。在功能上,它与直接迭代字典完全一致,但在某些需要强调语义或进行集合运算的场景下更为直观:
for key in user_profile.keys():
print(f"显式获取键: {key}")
在底层机制上,dict.keys() 返回的是一个 dict_keys 动态视图对象。该对象并不会在内存中额外复制一份列表,而是直接反映字典当前的状态。当字典发生变动时,该视图的内容会同步改变。
二、遍历字典的值(Values)
在很多业务场景中,我们并不在乎键的命名,只关心字典中保存的具体数值或对象列表,例如计算商品库存总量、统计服务器集群端口占用等。此时使用 values() 方法最为高效。
1. 使用 values() 进行迭代
直接通过 for value in dict.values(): 即可依次获得字典中的每一个值:
server_traffic_mb = {
"node_a": 1024,
"node_b": 2048,
"node_c": 512
}
total_traffic = 0
for traffic in server_traffic_mb.values():
total_traffic += traffic
print(f"总网络流量: {total_traffic} MB")
示例输出:
总网络流量: 3584 MB
for 循环,可以直接将 dict.values() 传递给 Python 内置函数,如 sum(server_traffic_mb.values()) 或 max(server_traffic_mb.values())。
2. 遍历值的注意事项
- 值允许重复:与字典键的唯一性不同,字典的值可以有相同数据。遍历时会忠实返回每一次出现的数值。
- 单向性限制:通过值反向查找对应的键需要重新遍历整个字典,时间复杂度为 O(N)。如果频繁需要“由值找键”,应考虑建立反向映射字典。
三、同时遍历键与值(Items)
在实际编码中,同时需要使用键和值的情况最为普遍,比如将配置拼装成命令行参数、输出结构化文本报告或过滤特定条目。Python 提供了 items() 方法配合元组解包(Tuple Unpacking)来实现这一功能。
1. items() 与元组解包语法
调用 dict.items() 会返回包含 (key, value) 二元元组的迭代视图。在 for 循环中,直接使用两个变量接收即可完成自动解包:
database_config = {
"host": "192.168.1.100",
"port": 5432,
"user": "db_admin",
"timeout": 30
}
# 循环中同时解包 key 和 value
for key, value in database_config.items():
print(f"配置项 [{key}] = {value}")
示例输出:
配置项 [host] = 192.168.1.100
配置项 [port] = 5432
配置项 [user] = db_admin
配置项 [timeout] = 30
四、遍历中的常见陷阱与避坑指南
在遍历字典的过程中,最容易出现的错误就是在迭代期间动态修改字典长度。了解其发生机理及正确解法,是编写健壮 Python 代码的重要一步。
1. 运行时错误:RuntimeError: dictionary changed size during iteration
如果在遍历字典时直接调用 del 或 pop() 删除元素,或者向字典添加新键,Python 解释器会抛出 RuntimeError 异常:
# 错误示例:遍历中直接删除元素
scores = {"Alice": 95, "Bob": 58, "Charlie": 45, "David": 88}
for student, score in scores.items():
if score < 60:
del scores[student] # 触发异常:RuntimeError
出现该错误的原因是:字典视图直接指向原字典的哈希结构,当在循环体内增删键时,字典内部的哈希表大小发生了改变。为了避免迭代器索引错乱或死循环,Python 底层设有安全检测机制,一旦发现字典长度变动,会立即主动中断并报错。
2. 两种安全修改方案
方案一:利用 list() 固化键列表快照
将 d.keys() 传入 list() 生成一个独立的新列表。此时循环迭代的是该静态列表,对原字典进行删除操作不会影响列表自身的迭代过程:
scores = {"Alice": 95, "Bob": 58, "Charlie": 45, "David": 88}
# list(scores.keys()) 复制出静态列表作为迭代快照
for student in list(scores.keys()):
if scores[student] < 60:
del scores[student]
print(f"清洗后的成绩字典: {scores}")
方案二:使用字典推导式(推荐)
在大多数数据清洗任务中,直接通过字典推导式生成一个符合条件的新字典更加清晰无副作用:
scores = {"Alice": 95, "Bob": 58, "Charlie": 45, "David": 88}
# 只保留成绩及格的键值对
passed_scores = {k: v for k, v in scores.items() if v >= 60}
print(f"及格名单: {passed_scores}")
五、进阶技巧:排序遍历与索引编号
在处理报表展示、日志打印或终端表格时,常常需要按照键的字母序、数值大小或带上行号进行格式化输出。
1. 按照键名排序遍历
通过内置函数 sorted() 包装字典或其视图,可以按升序或降序遍历键:
inventory = {"orange": 25, "apple": 40, "banana": 15}
# 按键名字母顺序升序遍历
for fruit in sorted(inventory.keys()):
print(f"水果: {fruit:8s} | 库存: {inventory[fruit]}")
2. 按照字典的值排序遍历
如果希望按照数值从高到低排序,可以将 inventory.items() 结合 key 参数与 lambda 函数使用:
# 按库存数量从大到小降序遍历
for fruit, count in sorted(inventory.items(), key=lambda item: item[1], reverse=True):
print(f"排名项: {fruit:8s} -> 数量: {count}")
3. 使用 enumerate() 获取遍历序号
如果打印时需要带上自增序号(从 1 开始计数的行号),可以用 enumerate() 将 dict.items() 包裹起来:
services = {"nginx": "running", "mysql": "running", "redis": "stopped"}
for idx, (svc_name, status) in enumerate(services.items(), start=1):
print(f"[{idx}] 服务: {svc_name} 状态: {status}")
六、字典遍历方法选型与决策导图
为了在实际编码中快速选择最合理的遍历语法,可以根据所需要的数据维度与操作目标进行选型决策:
七、方法总结与速查对照表
将上述遍历方式的关键特征汇总如下表,供日常开发参考:
| 遍历方式 | 核心语法 | 返回视图类型 | 典型应用场景 |
|---|---|---|---|
| 默认直接遍历 | for k in d: |
原字典迭代器 (yield keys) | 仅使用键名、判断键是否存在、代码最为精炼 |
| 显式遍历键 | for k in d.keys(): |
dict_keys |
需明确强调语义、对键进行并集/交集等集合运算 |
| 遍历数值 | for v in d.values(): |
dict_values |
仅关注业务数值、使用 sum/max/min 批量聚合 |
| 遍历键值对 | for k, v in d.items(): |
dict_items |
同时处理键和值、日志输出、配置文件参数组装 |
| 安全修改遍历 | for k in list(d.keys()): |
独立的静态 list 快照 |
需要在遍历过程中动态删除原字典中的特定键 |
| 推导式清洗 | {k: v for k, v in d.items() if ...} |
全新 dict 实例 |
条件筛选、键值翻转、函数式无副作用字典重构 |
掌握以上三种核心遍历方式及其视图机制,结合元组解包与安全快照技巧,即可在各类 Python 项目中准确、优雅且高效地处理字典数据。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













