Если список представляет собой ряд пронумерованных полей, то словарь Python представляет собой набор помеченных полей. Вы запрашиваете то, что хотите, по имени, а не по должности, поэтому словари стоят за данными JSON, конфигурацией, кэшами и большей частью самого Python.

Это руководство начинается с основ и переходит к шаблонам, которые опытные разработчики используют каждый день. Мы выполнили все примеры на Python 3.13, и показанный результат получен в результате этого запуска.

Что такое словарь?

Словарь, или dict, сопоставляет ключи с значениями. Каждый ключ появляется только один раз, а значения могут быть любыми, включая списки или другие словари.

Начиная с Python 3.7, словари официально сохраняют порядок вставки. Во многих старых руководствах они по-прежнему называются неупорядоченными, что уже не соответствует действительности. Для более широкого сравнения других типов см. Список Python, кортеж и набор.

Поиск выполняется быстро, поскольку словари используют хеш-таблицу. Проверка ключа занимает примерно одинаковое время независимо от того, содержит ли словарь десять элементов или миллион, тогда как поиск по списку замедляется по мере его роста.

Создать словарь

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'

Используйте квадратные скобки, когда ключ должен существовать, чтобы отсутствующий ключ громко выдавал ошибку. Используйте get(), когда отсутствие является нормальным, например, в качестве необязательного поля в ответе API. Чтобы проверить наличие ключа, используйте оператор 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 на месте.

Понимание и сортировка

Словарные генераторы создают новый словарь в одной читаемой строке, точно так же, как списковые генераторы делают это для списков:

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(), если вам нужен словарь в таком порядке.

Подсчет и группировка узоров

Постоянно возникают две задачи. Первый — подсчет, который вы можете выполнить, используя 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, []) дает каждому ключу один и тот же список. Вместо этого используйте понимание.
• Изменение размера во время итерации. Перебираем копию ключей.
• Использование dict для фиксированных, известных полей. dataclass может быть более понятным и выявлять опечатки в именах полей.

Итоги

Словари вознаграждают за небольшую практику. Помните get() для дополнительных клавиш, items() для циклов и Counter и defaultdict для двух наиболее распространенных заданий. Для практики возьмите небольшой файл JSON и напишите код для подсчета и группировки его записей. Если вы новичок в этом языке, начните с нашего Урока Python для начинающих.

Часто задаваемые вопросы

Продолжайте учиться