当前位置：首页 > Python > 正文

Python字典获取键的5种方法详解 | Python字典教程

SituKong
Python
2025-08-03
1215

Python字典获取键的5种方法详解

全面掌握Python字典中获取键值的各种技巧，避免KeyError异常，提升代码健壮性

Python字典基础

字典(Dictionary)是Python中一种非常强大的数据结构，它以键值对(key-value)的形式存储数据。字典提供快速的查找速度，是Python中最常用的数据结构之一。

在实际开发中，我们经常需要根据键(key)来获取对应的值(value)。Python提供了多种获取字典值的方法，每种方法都有其适用场景。本教程将详细介绍这些方法，帮助你根据具体情况选择最合适的方法。

5种获取字典值的方法

方括号表示法 []

这是最直接的方法，通过键名在方括号中访问对应的值。

适用场景： 当键一定存在于字典中时使用；如果键不存在会引发KeyError异常。

示例代码

# 创建示例字典
student = {
    "name": "张三",
    "age": 20,
    "major": "计算机科学"
}

# 使用方括号获取值
print(student["name"])  # 输出: 张三
print(student["age"])   # 输出: 20

# 尝试访问不存在的键 - 会引发KeyError
# print(student["grade"])

get() 方法

更安全的获取值方法，当键不存在时返回None或指定的默认值，避免KeyError异常。

适用场景： 当不确定键是否存在时使用；可以避免程序因KeyError而中断。

示例代码

# 使用get()方法获取值
print(student.get("name"))      # 输出: 张三
print(student.get("grade"))     # 输出: None

# 提供默认值
print(student.get("grade", "暂无成绩"))  # 输出: 暂无成绩

# 不影响原字典
print(student)  # 输出: {'name': '张三', 'age': 20, 'major': '计算机科学'}

setdefault() 方法

获取指定键的值，如果键不存在，则插入键并设置默认值，最后返回该值。

适用场景： 需要获取值同时可能初始化新键值对的情况；常用于初始化字典中的数据结构。

示例代码

# 使用setdefault()方法
# 键存在时
age = student.setdefault("age", 21)
print(age)  # 输出: 20 (原值不变)

# 键不存在时
grade = student.setdefault("grade", "A")
print(grade)  # 输出: A

# 字典已被更新
print(student)  # 输出: {'name': '张三', 'age': 20, 'major': '计算机科学', 'grade': 'A'}

# 初始化复杂数据结构
data = {}
data.setdefault("scores", []).append(90)
data.setdefault("scores", []).append(85)
print(data)  # 输出: {'scores': [90, 85]}

in 操作符检查键是否存在

使用in关键字检查键是否存在于字典中，然后决定如何获取值。

适用场景： 需要明确知道键是否存在，并根据情况执行不同操作时使用。

示例代码

# 使用in操作符检查键是否存在
if "name" in student:
    print(f"学生姓名: {student['name']}")
else:
    print("姓名信息缺失")

if "gpa" in student:
    print(f"GPA: {student['gpa']}")
else:
    print("GPA信息未记录")

# 与get()方法结合使用
value = student["gpa"] if "gpa" in student else 0.0
print(f"GPA值: {value}")

keys() 方法遍历键

使用keys()方法获取字典中所有键的视图，然后遍历或检查键。

适用场景： 需要处理字典中的所有键时；检查某个键是否存在（比in操作符效率稍低）。

示例代码

# 使用keys()方法
keys = student.keys()
print(keys)  # 输出: dict_keys(['name', 'age', 'major', 'grade'])

# 遍历所有键
print("学生信息包含以下字段:")
for key in student.keys():
    print(f"- {key}")

# 检查键是否存在
if "age" in student.keys():
    print("年龄字段存在")
    
# 转换为列表
key_list = list(student.keys())
print(key_list)  # 输出: ['name', 'age', 'major', 'grade']

方法比较与选择指南

方法	键不存在时	是否修改字典	返回值	使用建议
`[]` 操作符	引发KeyError异常	否	键对应的值	键一定存在时使用
`get()`	返回None或默认值	否	值或默认值	不确定键是否存在时
`setdefault()`	添加键并设置默认值	是	值或默认值	需要初始化键值对时
`in` 操作符	返回False	否	布尔值	需要检查键是否存在时
`keys()`	不包含在键列表中	否	键的视图	需要处理所有键时