第6章 字典

系列第 6 篇:本文是《Python编程 从入门到实践》读书笔记系列的第 6 篇。

本文内容:字典定义与访问、添加与修改键值对、删除键值对、遍历字典(items/keys/values)、嵌套(字典列表/列表字典/字典字典)。

本章目标:这一篇主要解决一个问题:当一条数据不再只是一个值,而是有多个属性时,怎么用 Python 把它组织清楚。

开篇:这篇解决什么问题

列表适合存“一组同类数据”,比如一批任务名、一组文件名、一串用户名称。但如果我要描述一个用户,只写成列表就不太直观:

user = ['lunzi', 'active', 7]

这段代码能跑,但过几天再看,很容易忘记 active 和 7 分别代表什么。字典更适合这种场景:

user = {

'username': 'lunzi',

'status': 'active',

'task_count': 7,

}

这样一看就清楚:左边是字段名,右边是具体值。我自己在工作里理解字典时,最早也是从“配置项”和“用户信息”这类场景开始的。只要数据开始有字段、有状态、有层级,字典就会变得很自然。

本篇你会学到什么

如何创建字典,并通过键访问对应的值

如何添加、修改、删除字典里的键值对

items()、keys()、values() 分别适合什么遍历场景

如何理解字典列表、字典中存列表、字典中存字典

常见的 KeyError 怎么排查,什么时候适合用 get()

场景案例:维护一份用户信息表

这一篇不用外星人、比萨这些例子做主线,我们换成更贴近实际工作的场景:维护一份简单的用户信息表。

假设我们要记录用户的基础信息、状态、权限和最近处理的任务,可以先从一个用户开始:

user = {

'username': 'alice',

'role': 'admin',

'status': 'active',

'task_count': 5,

}

print(user['username'])

print(user['role'])

这就是字典最核心的用法:用一个明确的“键”,找到对应的“值”。

如果后续用户信息变多,我们可以把多个字典放进列表里:

users = [

{'username': 'alice', 'role': 'admin', 'status': 'active'},

{'username': 'bob', 'role': 'developer', 'status': 'inactive'},

{'username': 'charlie', 'role': 'tester', 'status': 'active'},

]

for user in users:

print(user['username'] + ' - ' + user['status'])

这类结构在实际脚本里很常见:一组用户、一组任务、一组配置、一组接口返回数据,都可以这样组织。

知识点拆解

1. 创建字典

字典使用 {} 表示,里面是一组键值对:

user = {

'username': 'alice',

'role': 'admin',

'status': 'active',

}

可以把它理解成一张小表:

username

alice

role

admin

status

active

键通常用字符串,值可以是字符串、数字、列表、另一个字典等。

2. 访问字典中的值

访问字典时,用 字典名[键]:

user = {

'username': 'alice',

'role': 'admin',

'task_count': 5,

}

print(user['username'])

print(user['task_count'])

输出结果:

alice

5

这个写法很直接,但有一个前提:这个键必须存在。如果键不存在,就会报 KeyError。

3. 添加键值对

字典可以在创建之后继续添加内容:

user = {

'username': 'alice',

'role': 'admin',

}

user['status'] = 'active'

user['task_count'] = 5

print(user)

这在写脚本时很常见:先拿到一部分信息,后面再补充状态、统计结果或处理结果。

4. 修改字典中的值

修改字典也使用同样的写法:

user = {

'username': 'alice',

'status': 'active',

}

user['status'] = 'inactive'

print(user['status'])

如果把字典看成一份用户档案,修改值就像更新用户状态。

5. 删除键值对

删除字典里的某个字段,用 del:

user = {

'username': 'alice',

'role': 'admin',

'temporary_token': 'abc123',

}

del user['temporary_token']

print(user)

注意:del 删除后,这个键值对就没有了。后面如果还访问 user['temporary_token'],会报错。

6. 遍历所有键值对:items()

如果想把字典里的键和值都拿出来,用 items():

user = {

'username': 'alice',

'role': 'admin',

'status': 'active',

}

for key, value in user.items():

print(key + ': ' + value)

输出结果:

username: alice

role: admin

status: active

这个方法适合做配置检查、日志输出、字段展示。

7. 遍历所有键:keys()

如果只关心有哪些字段,可以遍历键:

user = {

'username': 'alice',

'role': 'admin',

'status': 'active',

}

for key in user.keys():

print(key)

其实直接写 for key in user: 也可以,默认遍历的就是键:

for key in user:

print(key)

初学阶段建议先写清楚一点,用 keys() 更容易看出意图。

8. 遍历所有值:values()

如果只关心值,用 values():

favorite_languages = {

'alice': 'python',

'bob': 'java',

'charlie': 'python',

}

for language in favorite_languages.values():

print(language)

如果想去重,可以配合 set():

for language in set(favorite_languages.values()):

print(language)

这里 set() 会把重复的值合并掉。比如多个用户都喜欢 Python,最后只显示一次。

9. 字典列表:一组结构相似的数据

当你有多个用户,每个用户都有自己的字段时,可以使用“列表中存字典”:

users = [

{'username': 'alice', 'role': 'admin', 'status': 'active'},

{'username': 'bob', 'role': 'developer', 'status': 'inactive'},

{'username': 'charlie', 'role': 'tester', 'status': 'active'},

]

for user in users:

if user['status'] == 'active':

print(user['username'] + ' is active.')

这类结构在实际工作里非常常见。比如:

批量用户信息

批量任务列表

批量订单数据

批量接口返回结果

10. 字典中存列表:一个字段对应多个值

有时候,一个字段不是单个值,而是一组值。比如一个用户可以有多个权限:

user = {

'username': 'alice',

'permissions': ['read', 'write', 'delete'],

}

print(user['username'] + ' has permissions:')

for permission in user['permissions']:

print('- ' + permission)

这比写成 permission1、permission2、permission3 更清楚,也更方便循环处理。

11. 字典中存字典:更复杂的结构化数据

如果每个用户还有更详细的信息,可以把字典嵌套在字典里:

users = {

'alice': {

'role': 'admin',

'status': 'active',

'location': 'beijing',

},

'bob': {

'role': 'developer',

'status': 'inactive',

'location': 'shanghai',

},

}

for username, info in users.items():

print(username)

print(' role: ' + info['role'])

print(' status: ' + info['status'])

print(' location: ' + info['location'])

嵌套结构不要一开始就写得太复杂。我的习惯是:先看数据要表达什么,再决定用列表还是字典。如果只是“一组值”,优先列表;如果是“一个对象的多个属性”,优先字典;如果是“一组对象”,通常就是列表里放字典。

初学者容易踩的坑

问题

常见原因

建议

KeyError

访问了不存在的键

先用 in 判断,或者用 get()

分不清键和值

不知道该遍历 keys() 还是 values()

要字段名用 keys(),要字段值用 values(),两个都要用 items()

嵌套结构看不懂

列表和字典混在一起

先一层一层看:外层是什么,内层是什么

直接赋值导致联动修改

两个变量指向同一个字典

需要复制时用 copy(),复杂结构再考虑 deepcopy

字典结构太随意

每条数据字段不统一

同一批数据尽量保持相同字段

KeyError 怎么排查

这是字典里最常见的错误:

user = {

'username': 'alice',

'role': 'admin',

}

print(user['status'])

因为 status 不存在,所以会报错。

更稳一点的写法是:

if 'status' in user:

print(user['status'])

else:

print('status is missing')

也可以用 get():

status = user.get('status', 'unknown')

print(status)

get() 的第二个参数是默认值。键不存在时,不会报错,而是返回默认值。

工作里能怎么用

字典在工作里特别常见,因为很多业务数据天然就是键值对。

场景

字典可以怎么用

配置文件

存接口地址、超时时间、重试次数

用户信息

存用户名、角色、状态、权限

任务管理

存任务名称、负责人、截止时间、执行状态

接口数据

JSON 转成 Python 后通常就是字典或列表嵌套字典

日志统计

用字段保存次数、状态、耗时等结果

举个更贴近脚本的小例子:

task = {

'name': 'daily_report',

'owner': 'alice',

'status': 'pending',

'retry_count': 0,

}

if task['status'] == 'pending':

print('Run task: ' + task['name'])

task['status'] = 'running'

这个例子不复杂,但已经能体现字典的价值:它让一条任务数据变得更清楚,也更容易扩展。

小结

字典用来保存键值对,适合表达“一个对象的多个属性”

访问字典用 dict[key],但键不存在时会报 KeyError

添加和修改都使用 dict[key] = value

删除键值对用 del dict[key]

遍历键值对用 items(),遍历键用 keys(),遍历值用 values()

一组对象可以用“列表中存字典”

一个字段有多个值,可以用“字典中存列表”

更复杂的数据可以用“字典中存字典”,但不要一开始就嵌套太深

下一篇

下一篇继续讲 input() 和 while 循环。前面我们已经能用列表和字典组织数据了,接下来就让程序接收用户输入,并根据用户的选择持续运行。