Python字典怎么遍历?获取键、值及键值对的方法

拾光
拾光
发布时间:2026-11-17 | 7人浏览过
原创

详细介绍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 动态视图对象。该对象并不会在内存中额外复制一份列表,而是直接反映字典当前的状态。当字典发生变动时,该视图的内容会同步改变。

Python字典怎么遍历?获取键、值及键值对的方法
图 1:Python 字典核心结构与三种视图对象机制对照图

二、遍历字典的值(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字典怎么遍历?获取键、值及键值对的方法
图 2:for key, value in dict.items() 元组解包执行流程图

四、遍历中的常见陷阱与避坑指南

在遍历字典的过程中,最容易出现的错误就是在迭代期间动态修改字典长度。了解其发生机理及正确解法,是编写健壮 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 底层设有安全检测机制,一旦发现字典长度变动,会立即主动中断并报错。

Python字典怎么遍历?获取键、值及键值对的方法
图 3:遍历中修改字典的报错根因与两种安全方案对比图

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}")

六、字典遍历方法选型与决策导图

为了在实际编码中快速选择最合理的遍历语法,可以根据所需要的数据维度与操作目标进行选型决策:

Python字典怎么遍历?获取键、值及键值对的方法
图 4:Python 字典遍历方法选型与决策流程导图

七、方法总结与速查对照表

将上述遍历方式的关键特征汇总如下表,供日常开发参考:

遍历方式 核心语法 返回视图类型 典型应用场景
默认直接遍历 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 项目中准确、优雅且高效地处理字典数据。

相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表