목록이 번호가 매겨진 상자의 행인 경우, Python 사전은 레이블이 있는 사전입니다. 위치보다는 이름으로 원하는 것을 요청합니다. 이것이 사전이 JSON 데이터, 구성, 캐시 및 Python 자체의 대부분 뒤에 있는 이유입니다.

이 튜토리얼은 기본부터 시작하여 숙련된 개발자가 매일 사용하는 패턴으로 넘어갑니다. Python 3.13에서 모든 예제를 실행했으며 표시된 출력은 해당 실행에서 나온 것입니다.

사전이란 무엇입니까?

사전 또는 dict은 키를 값에 매핑합니다. 각 키는 한 번만 나타나며 값은 목록이나 기타 사전을 포함하여 무엇이든 될 수 있습니다.

Python 3.7부터 사전은 공식적으로 삽입 순서를 유지합니다. 많은 오래된 튜토리얼에서는 여전히 이를 순서가 없다고 부르는데, 이는 더 이상 사실이 아닙니다. 다른 유형에 대한 더 광범위한 비교는 Python 목록 대 튜플 대 집합을 참조하세요.

사전은 해시 테이블을 사용하므로 조회가 빠릅니다. 사전에 항목이 10개든 100만 개든 키를 확인하는 데는 거의 같은 시간이 걸리는 반면, 목록 검색은 항목이 많아질수록 속도가 느려집니다.

사전 만들기

user = {"name": "Asha", "age": 31, "city": "Pune"}

empty = {}
from_keywords = dict(name="Asha", age=31)
from_pairs = dict([("a", 1), ("b", 2)])

중괄호가 가장 일반적인 형태입니다. 하나의 트랩: {}은 빈 세트가 아닌 빈 사전을 생성합니다. 빈 세트의 경우 set()가 필요합니다.

안전하게 값 읽기

값을 읽는 방법에는 두 가지가 있으며 키가 존재하지 않는 경우 차이점이 중요합니다.

user["name"]                  # 'Asha'
user["email"]                 # KeyError: 'email'

user.get("email")             # None
user.get("email", "not set")  # 'not set'

키가 있어야 하는 경우 대괄호를 사용하여 누락된 키가 크게 실패하도록 합니다. API 응답의 선택적 필드와 같이 부재가 일반적인 경우 get()을 사용하세요. 키를 확인하려면 값이 아닌 키를 확인하는 in 연산자를 사용하세요.

"city" in user    # True
"Pune" in user    # False

추가, 업데이트 및 제거

키에 할당하면 키가 있으면 업데이트되고, 없으면 추가됩니다.

user["age"] = 32
user["email"] = "asha@example.com"
print(user)

# {'name': 'Asha', 'age': 32, 'city': 'Pune', 'email': 'asha@example.com'}

Python은 항목을 제거하는 여러 가지 방법을 제공합니다.

user.pop("city")          # returns 'Pune' and removes it
user.pop("phone", None)   # no error if it is missing
del user["email"]         # removes it, and raises KeyError if missing
user.clear()              # empties the dictionary

값을 다시 원하면 pop()을 사용하십시오. 두 번째 인수로 기본값을 전달하면 키가 없을 때 발생하는 오류를 방지할 수 있습니다. popitem()는 가장 최근에 추가된 쌍을 제거하고 반환합니다.

사전 반복

반복하면 키를 직접 얻을 수 있습니다. 키와 값을 모두 얻으려면 items()을 사용하십시오.

user = {"name": "Asha", "age": 32}

for key, value in user.items():
    print(key, "=", value)

# name = Asha
# age = 32

keys(), values() 및 items()은 복사본이 아닌 라이브 뷰를 반환하므로 이후 변경 사항을 반영합니다. Python은 RuntimeError를 발생시키기 때문에 사전을 반복하는 동안 키를 추가하거나 제거하지 마십시오. 그렇게 해야 한다면 list(user)를 반복하세요.

사전 방법 치트 시트

사전 병합

일반적인 요구 사항은 기본값 위에 사용자 설정을 적용하는 것입니다. 키가 충돌하면 오른쪽이 승리합니다.

defaults = {"theme": "light", "lang": "en"}
saved = {"theme": "dark"}

defaults | saved
{**defaults, **saved}

# Both give: {'theme': 'dark', 'lang': 'en'}

| 연산자에는 Python 3.9 이상이 필요하지만 ** 버전은 이전 버전에서도 작동합니다. 둘 다 새 사전을 만듭니다. 대조적으로, defaults.update(saved)과 defaults |= saved는 defaults를 제자리에서 변경합니다.

이해와 정렬

Dictionary comprehension은 list comprehension이 목록에 대해 하는 것과 마찬가지로 읽을 수 있는 단일 줄에 새 사전을 만듭니다.

prices = {"pen": 10, "book": 250, "bag": 900}

{k: v for k, v in prices.items() if v > 100}
# {'book': 250, 'bag': 900}

값을 기준으로 정렬하려면 key 함수를 sorted()에 전달하세요. 가장 큰 값을 가진 키를 찾으려면 max()을 사용하십시오.

sorted(prices.items(), key=lambda item: item[1], reverse=True)
# [('bag', 900), ('book', 250), ('pen', 10)]

max(prices, key=prices.get)
# 'bag'

사전에는 sort() 메서드가 없으며 sorted()는 쌍 목록을 반환합니다. 사전을 해당 순서로 원하면 결과를 dict()으로 묶습니다.

패턴 계산 및 그룹화

두 가지 작업이 끊임없이 발생합니다. 첫 번째는 계산입니다. 기본값은 0인 get()을 사용하여 수행할 수 있습니다.

words = "to be or not to be".split()

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

print(counts)
# {'to': 2, 'be': 2, 'or': 1, 'not': 1}

표준 라이브러리는 Counter을 사용하여 이를 더욱 짧게 만듭니다.

from collections import Counter

Counter(words).most_common(2)
# [('to', 2), ('be', 2)]

두 번째는 그룹화이며 defaultdict은 누락된 값을 생성하므로 여기서 이상적입니다.

from collections import defaultdict

orders = [("Asha", 1200), ("Ben", 300), ("Asha", 800)]

by_customer = defaultdict(list)
for name, total in orders:
    by_customer[name].append(total)

print(dict(by_customer))
# {'Asha': [1200, 800], 'Ben': [300]}

이것이 없으면 추가하기 전에 각 키가 존재하는지 확인해야 합니다. 이와 동일한 패턴은 API 데이터 또는 로그 라인을 집계하는 데 적합합니다. 사전이 비어 있거나 키가 누락된 경우 Python 예외 처리 가이드에서는 결과 KeyError를 처리하는 방법을 보여줍니다.

중첩된 데이터 및 복사 트랩

JSON은 중첩된 사전 및 목록에 직접 매핑되므로 키를 연결하는 경우가 많습니다. 체인 get()은 레벨이 누락되었을 때 이를 안전하게 유지합니다.

response = {"user": {"profile": {"city": "Pune"}}}

response["user"]["profile"]["city"]               # 'Pune'
response.get("user", {}).get("settings", {}).get("theme")   # None

중첩된 데이터를 복사할 때는 주의하세요. copy()은 최상위 수준만 복제하므로 내부 사전은 원본과 공유됩니다.

settings = {"db": {"host": "localhost"}}

shallow = settings.copy()
shallow["db"]["host"] = "prod"

print(settings["db"]["host"])
# prod

복사본을 변경하면 원본이 변경되는데 이는 불쾌한 버그가 될 수 있습니다. 완전히 독립적인 복사본을 얻으려면 copy.deepcopy(settings)을 사용하십시오.

사전 키는 무엇입니까?

키는 해시 가능해야 하며 이는 일반적으로 변경할 수 없음을 의미합니다. 문자열, 숫자, 불변 값의 튜플이 모두 작동합니다. 목록과 사전은 다음을 수행하지 않습니다.

{["a"]: 1}

# TypeError: unhashable type: 'list'

그 이유는 키의 해시가 해당 값이 저장되는 위치를 결정하기 때문입니다. 키가 변경될 수 있으면 Python은 더 이상 키를 찾을 수 없습니다. 복합 키가 필요한 경우 {("Pune", 2026): 120}과 같은 튜플을 사용하세요.

일반적인 실수

• 옵션 키에 대괄호를 사용합니다. 키가 없을 수 있는 경우 get()에 도달하세요.
• get()는 키가 존재한다는 것을 의미한다고 가정합니다. None은 누락되었거나 저장된 None를 의미할 수 있습니다. 차이가 중요한 경우 in를 사용하세요.
• 변경 가능한 기본값을 사용합니다. dict.fromkeys(names, []) 모든 키에 동일한 목록이 제공됩니다. 대신 이해력을 사용하십시오.
• 반복 중 크기 변경. 키 복사본을 반복합니다.
• 고정된 알려진 필드에 사전을 사용합니다. dataclass가 더 명확할 수 있으며 필드 이름의 오타를 잡아냅니다.

마무리

사전은 약간의 연습에 대한 보상입니다. 선택적 키는 get(), 루프는 items(), 가장 일반적인 두 가지 작업은 Counter과 defaultdict를 기억하세요. 연습하려면 작은 JSON 파일을 가져와서 레코드 수를 세고 그룹화하는 코드를 작성하세요. 언어를 처음 사용하는 경우 초보자를 위한 Python 튜토리얼부터 시작하세요.

자주 묻는 질문

계속 학습하세요