Python 字典的 get() 方法詳解：新手指南

Published October 2, 2024 by 徐培鈞
Python

在 Python 編程中，字典（Dictionary） 是一種用於存儲 鍵-值對（key-value pair） 的強大數據結構。

當我們在操作字典時，經常需要根據鍵來獲取對應的值。

為了安全、有效地進行這一操作，Python 提供了 get() 方法。

本篇文章將詳細介紹 Python 字典的 get() 方法，包括其基本用法、優勢、實際應用和注意事項，幫助新手更好地掌握這一重要工具。

什麼是字典的 get() 方法？

定義

get() 方法是字典物件的一個內建方法，用於根據指定的鍵 安全地 獲取對應的值。

如果鍵不存在，get() 方法可以返回一個默認值，而不會引發 KeyError 異常。

作用

  • 避免程序崩潰：在直接訪問字典的鍵時，如果鍵不存在，會引發 KeyError，導致程序崩潰。使用 get() 方法可以避免這種情況。
  • 提供默認值：可以為不存在的鍵設置一個默認值，方便處理缺失的數據。

get() 方法的基本語法

value = dictionary.get(key, default=None)
  • dictionary：字典物件。
  • key：要查找的鍵。
  • default（可選）：如果鍵不存在，返回的默認值。默認為 None。

get() 方法的基本用法

獲取存在的鍵的值

示例：

student = {'name': 'Alice', 'age': 20, 'grade': 'A'}
name = student.get('name')
print(name)  # 輸出：Alice

解釋：

  • 鍵 'name' 存在於字典中，get() 方法返回對應的值 'Alice'。

獲取不存在的鍵的值（使用默認值）

示例：

grade = student.get('grade')
print(grade)  # 輸出：A

major = student.get('major')
print(major)  # 輸出：None

解釋：

  • 鍵 'major' 不存在於字典中，get() 方法返回默認值 None。

為不存在的鍵設置自定義默認值

示例：

major = student.get('major', '未指定專業')
print(major)  # 輸出：未指定專業

解釋：

  • 通過指定默認值 '未指定專業'，當鍵 'major' 不存在時，get() 方法返回該默認值。

get() 方法的優勢

避免 KeyError 異常

直接訪問不存在的鍵會引發 KeyError，導致程序中斷。

示例：

# 直接訪問不存在的鍵
student = {'name': 'Alice', 'age': 20, 'grade': 'A'}
print(student['major'])  # 引發 KeyError: 'major'

解決方案：

  • 使用 get() 方法安全地獲取值，避免程序崩潰。

提高代碼的健壯性

  • 通過提供默認值，可以在數據缺失時有合理的處理方式，增強程序的健壯性。

簡化代碼

  • 使用 get() 方法，可以避免額外的條件判斷，讓代碼更加簡潔。

實際應用示例

計算單詞出現次數

示例：

text = "apple banana apple strawberry banana apple"
words = text.split()
word_count = {}

for word in words:
    word_count[word] = word_count.get(word, 0) + 1

print(word_count)
# 輸出：{'apple': 3, 'banana': 2, 'strawberry': 1}

解釋：

  • 使用 get() 方法，當單詞第一次出現時，返回默認值 0，然後累加計數。
  • 如果單詞已在字典中：
    • word_count.get(word, 0) 返回該單詞的當前計數。
    • 加上 1，表示該單詞又出現了一次。
    • 更新字典中該單詞的計數。
  • 如果單詞不在字典中：
    • word_count.get(word, 0) 返回默認值 0。
    • 加上 1，表示該單詞第一次出現，計數為 1。
    • 將該單詞和計數添加到字典中。

處理用戶輸入的配置

示例：

config = {'theme': 'dark', 'language': 'en'}

# 獲取用戶設置，若未設置則使用默認值
theme = config.get('theme', 'light')
language = config.get('language', 'zh-tw')

print(f"主題：{theme}")
print(f"語言：{language}")

輸出：

主題：dark
語言：en

解釋：

  • 如果用戶沒有設置某項配置，程序將使用預設值，確保配置的完整性。

解析 JSON 數據

示例：

import json

json_str = '{"name": "Alice", "age": 25}'
data = json.loads(json_str)

# 獲取可能缺失的鍵
email = data.get('email', '未提供電子郵件')
print(email)  # 輸出：未提供電子郵件

解釋：

  • 在處理可能缺失字段的數據時，使用 get() 方法可以避免異常。

與條件判斷的比較

使用 if 判斷鍵是否存在

示例：

if 'major' in student:
    major = student['major']
else:
    major = '未指定專業'

使用 get() 方法

示例：

major = student.get('major', '未指定專業')

比較：

  • 代碼更簡潔：get() 方法一行代碼即可實現同樣的功能。
  • 可讀性更高：get() 方法的語義清晰，易於理解。

get() 方法的注意事項

默認值的選擇

  • 默認值可以是任何類型的數據，包括 None、數字、字串、列表、字典等。
  • 根據實際需求選擇合適的默認值，以確保程序的正確性。

不影響字典本身

  • 使用 get() 方法時，如果鍵不存在，字典本身不會新增該鍵。
  • 如果需要在鍵不存在時同時設置默認值，可以使用 setdefault() 方法。

示例：

value = student.setdefault('major', '未指定專業')
print(student)
# 輸出：{'name': 'Alice', 'age': 20, 'grade': 'A', 'major': '未指定專業'}

解釋：

  • setdefault() 方法在鍵不存在時，設置鍵的值為默認值，並返回該值。

常見錯誤與調試

忘記提供默認值

  • 如果沒有提供默認值，且鍵不存在，get() 方法將返回 None。

示例：

value = student.get('major')
print(value)  # 輸出：None
  • 注意事項：需要檢查返回值是否為 None，以避免後續操作出現問題。

將 get() 方法誤用於列表

  • get() 方法是字典的方法，不能用於列表等其他數據類型。

錯誤示例：

my_list = [1, 2, 3]
value = my_list.get(0)
# AttributeError: 'list' object has no attribute 'get'

解決方案：

  • 使用列表的索引訪問元素，或使用 try-except 捕獲索引錯誤。

總結

  • get() 方法 是 Python 字典中用於安全獲取值的實用工具。
  • 主要優勢：
    • 避免 KeyError，提高程序的健壯性。
    • 提供默認值，方便處理缺失的數據。
    • 簡化代碼，提高可讀性。
  • 使用注意事項：
    • 根據需求設置合適的默認值。
    • 注意 get() 方法不會修改字典本身。

延伸閱讀