Кортежи в Python: как создать tuple, распаковать и чем он отличается от списка

Кортеж в Python похож на список в круглых скобках, только изменить его после создания нельзя.

На примерах показываем, как создать кортеж (и почему для одного элемента нужна запятая), достать элементы, распаковать их в переменные и сделать кортеж ключом словаря.

В конце сводная таблица отличий от списка и три задачи для самопроверки.

Статью написал:
Ваня Буявец, продюсер, основатель Checkroi
Ваня Буявец
Основатель Checkroi, продюсер, эксперт в выборе онлайн-курсов
Все 3392 статьи автора Подписаться на Телеграм-канал
Одобрено экспертом:
Наташа Буявец, основатель Checkroi, эксперт по онлайн-курсам
Наташа Буявец
Основательница Checkroi, продюсер Youtube-каналов, эксперт по онлайн-курсам
Все 4045 экспертных мнений Подписаться на Телеграм-канал
Обложка: Кортежи в Python: как создать tuple, распаковать и чем он отличается от списка

Кортеж в Python выглядит как список в круглых скобках: (1, 2, 3) вместо [1, 2, 3]. Разница в скобках кажется косметической, пока не попробуешь поменять элемент и не получишь TypeError.

Ниже показано, что такое кортеж (tuple) в Python простыми словами, как его создать, достать элемент, распаковать в переменные, чем он отличается от списка и почему его можно сделать ключом словаря. Сообщения об ошибках приведены по Python 3.14: в старых версиях их текст бывает короче.

Если вы только знакомитесь с языком, сначала пригодится обзор всех встроенных типов: типы данных в Python с примерами. Кортеж в нём стоит рядом со списком, словарём и множеством.

Слово «кортеж» живёт и за пределами программирования: так называют строку таблицы в базах данных и упорядоченный набор чисел в математике. Все значения слова разобраны в материале «Кортеж: что это такое простыми словами», а здесь речь только о Python.

Кто хочет освоить язык системно, а не по одной теме за вечер, найдёт программы для новичков в нашей подборке курсов по Python.

Что такое кортеж в Python

Рой за ноутбуком с кортежем на экране

Кортеж (tuple) — это упорядоченная неизменяемая последовательность элементов. Английское tuple так и переводится: кортеж.

Упорядоченная значит, что у каждого элемента есть номер, индекс, и порядок не меняется сам по себе. Первый элемент всегда первый. Неизменяемая значит, что после создания кортежа нельзя заменить, добавить или удалить ни одного элемента. Можно только собрать новый кортеж.

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

user = ('Аня', 25, 'Казань')
print(user)
print(type(user))
('Аня', 25, 'Казань')
<class 'tuple'>

В документации Python кортеж описан как неизменяемая последовательность, которую обычно используют для хранения разнородных данных. Отсюда простое правило: кортеж хранит одну запись из нескольких полей, например имя, возраст и город одного человека. Список чаще хранит много однотипных вещей: имена всех учеников класса.

Как создать кортеж

Способов пять, и в двух из них прячется подвох, на котором новички ошибаются чаще всего.

Через круглые скобки и запятые

Самый привычный вариант: перечислить элементы через запятую в круглых скобках.

point = (3, 4)
colors = ('red', 'green', 'blue')

Без скобок

Скобки можно не ставить вовсе. Python сам соберёт значения в кортеж, это называется упаковкой:

x = 1, 2, 3
print(x, type(x))
(1, 2, 3) <class 'tuple'>

По справочнику Python кортеж создаёт именно запятая. Скобки обязательны только для пустого кортежа и там, где без них выражение читается двусмысленно.

Кортеж из одного элемента

Вот первый подвох. Число в скобках остаётся просто числом:

print(type((5)))
print(type((5,)))
<class 'int'>
<class 'tuple'>

Чтобы получить кортеж из одного элемента, после значения ставят запятую: (5,). Учебник Python называет этот синтаксис некрасивым, но рабочим.

Пустой кортеж

Пустой кортеж создают пустыми скобками () или вызовом tuple() без аргументов. Оба варианта дают одно и то же.

empty = ()
also_empty = tuple()
print(len(empty), len(also_empty))
0 0

Через функцию tuple()

Функция tuple() превращает в кортеж любую последовательность: список, строку, диапазон range. Так из списка делают кортеж.

print(tuple([1, 2]))
print(tuple(range(4)))
print(tuple('abc'))
(1, 2)
(0, 1, 2, 3)
('a', 'b', 'c')

Второй подвох в последней строке. Строку tuple() разбивает на буквы, а кортеж с одним словом так не получить. Нужен кортеж ('abc',), пишите запятую.

Запомнить. Кортеж делает запятая. (5) это число, (5,) это кортеж, а 5, без скобок тоже кортеж.

Канал основателя Checkroi Вани Буявца3 800 человек читают мой Телеграм-канал про нейросетиСобрал промпты для Claude Code и ChatGPT, разборы ИИ-инструментов и лайфхаки по продвижению бизнеса в одном местеПрисоединиться

Как достать элемент: индексы и срезы

С индексами кортеж работает так же, как список и строка. Нумерация начинается с нуля, отрицательный индекс считает с конца.

s = (1, 2, 3, 4)
print(s[0], s[-1])
print(s[1:3])
print(s[::-1])
1 4
(2, 3)
(4, 3, 2, 1)

Срез кортежа тоже кортеж, а исходный кортеж при этом не меняется. Как устроены шаг и отрицательные границы, подробно показано в статье про срезы в Python.

Если попросить индекс, которого нет, Python остановит программу:

t = (1, 2, 3)
t[5]
IndexError: tuple index out of range

Что можно делать с кортежем

Всё, что не меняет сам кортеж. Python поддерживает для кортежей все общие операции последовательностей: длину, проверку вхождения, склейку, повторение, минимум и максимум.

t = (1, 2, 2, 3, 2)
print(len(t))
print(2 in t)
print((1, 2) + (3,))
print((0,) * 3)
print(min(t), max(t), sum(t))
5
True
(1, 2, 3)
(0, 0, 0)
1 3 10

Склейка через + и повторение через * не трогают исходные кортежи. Они собирают новый.

Перебор в цикле

Кортеж перебирают циклом for, как любую последовательность. Если нужен ещё и номер элемента, помогает enumerate(): на каждом шаге она отдаёт пару «номер, значение», и эта пара сама по себе кортеж.

for i, v in enumerate(('a', 'b')):
    print(i, v)
0 a
1 b

Больше примеров с for и while собрано в статье про циклы в Python, а про нумерацию элементов подробно рассказано в разборе функции enumerate().

Сравнение кортежей

Кортежи сравниваются поэлементно, слева направо: сначала первые элементы, при равенстве вторые и так далее. Документация называет это лексикографическим порядком, как в словаре.

print((1, 2, 3) < (1, 3))
print((2,) > (1, 9, 9))
True
True

Во втором примере длина не важна. Решает первый же несовпавший элемент: 2 больше 1.

Сортировка кортежа

Отсортировать кортеж на месте нельзя, у него нет метода sort(). Функция sorted() работает, но возвращает список:

t = (3, 1, 2)
print(sorted(t))
print(tuple(sorted(t)))
[1, 2, 3]
(1, 2, 3)

Нужен снова кортеж, оберните результат в tuple(). Чем sorted() отличается от sort() у списков, показано в статье про метод sort() в Python.

Методы кортежей: count() и index()

У списка 11 методов, а у кортежа всего два. Это легко проверить функцией dir(), если отбросить служебные имена с подчёркиванием:

print([m for m in dir(tuple) if not m.startswith('_')])
['count', 'index']

Остальные методы списка что-то меняют внутри: добавляют, удаляют, сортируют. Кортежу они не положены.

count(x) считает, сколько раз x встречается в кортеже. index(x) возвращает номер первого вхождения:

t = (1, 2, 2, 3, 2)
print(t.count(2))
print(t.index(3))
3
3

Если элемента нет, index() падает с ошибкой, поэтому перед вызовом удобно проверить x in t:

ValueError: tuple.index(x): x not in tuple

Оба метода работают одинаково у кортежей, списков и строк. Подробности и примеры со строками есть в статьях про метод count() и метод index().

CheckroiCheckroiПодборка курсов по Python587 курсов • 55 школСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить→

Почему кортеж нельзя изменить и как всё-таки поменять данные

Попытка заменить, удалить или добавить элемент заканчивается ошибкой. Вот три типичные попытки и ответ Python 3.14 на каждую:

t = (1, 2, 3)
t[0] = 5     # TypeError: 'tuple' object does not support item assignment
del t[0]     # TypeError: 'tuple' object doesn't support item deletion
t.append(4)  # AttributeError: 'tuple' object has no attribute 'append'

Это и есть неизменяемость. В обмен кортеж даёт защиту: если передать его в чужую функцию, она не сможет тихо испортить ваши данные.

Как добавить элемент в кортеж

Напрямую никак. Есть два обходных пути, и оба создают новый кортеж вместо старого.

Первый путь: склеить старый кортеж с новым из одного элемента. Запятая в (4,) обязательна, без неё Python попытается сложить кортеж с числом.

a = (1, 2, 3)
b = a + (4,)
print(a, b)
(1, 2, 3) (1, 2, 3, 4)

Второй путь удобен, когда правок много: превратить кортеж в список, поменять что нужно и собрать кортеж обратно.

s = (1, 2, 3)
l = list(s)
l.append(4)
s = tuple(l)
print(s)
(1, 2, 3, 4)

Если данные меняются постоянно, это сигнал взять список. Как добавлять в список элементы и даже целые кортежи, разобрано в статье «Как добавить элемент в список Python».

Список внутри кортежа меняется

Неизменяемость касается только самого кортежа: какие объекты в нём лежат и в каком порядке. Если среди них есть список, менять сам список никто не запрещает. Учебник Python отдельно оговаривает, что в кортеже могут лежать изменяемые объекты, например списки.

t = (1, [2])
t[1].append(3)
print(t)
(1, [2, 3])

С оператором += получается совсем странно: Python выдаёт ошибку, но список всё равно меняется.

t = (1, [2])
try:
    t[1] += [3]
except TypeError as e:
    print(e)
print(t)
'tuple' object does not support item assignment
(1, [2, 3])

Список успел расшириться, а потом Python попытался записать результат обратно в кортеж и упал. Этот случай разобран в официальном FAQ по программированию.

Практический вывод. Если нужен кортеж, который точно не изменится, кладите в него только неизменяемые значения: числа, строки и другие кортежи.

Ваня БуявецКанал основателя Checkroi Вани БуявцаЗабирайте промпты и обучение по нейросетям в моём Телеграм-каналеБольше 3 800 человек уже применяют Claude Code, ChatGPT и другие нейросети в работе, учёбе, бизнесе и жизниПерейти в канал

Распаковка кортежа

Рой раскладывает содержимое коробки по полкам

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

name, age = ('Аня', 25)
print(f'{name}: {age}')
Аня: 25

Переменных слева должно быть ровно столько, сколько элементов справа. Иначе Python 3.14 подскажет, сколько ждал и сколько получил:

a, b = (1, 2, 3)     # ValueError: too many values to unpack (expected 2, got 3)
a, b, c = (1, 2)     # ValueError: not enough values to unpack (expected 3, got 2)

Когда длина заранее неизвестна, лишнее собирают звёздочкой. В переменную со звёздочкой попадает список оставшихся элементов:

first, *rest = (1, 2, 3, 4)
print(first, rest)
1 [2, 3, 4]

Обмен значений двух переменных

Та же механика меняет переменные местами без третьей временной переменной. Справа упаковка в кортеж, слева распаковка:

a, b = 1, 2
a, b = b, a
print(a, b)
2 1

Чем кортеж отличается от списка

Различия удобнее видеть рядом, поэтому сначала сводная таблица, а под ней пояснения к цифрам замеров.

Что сравниваем Кортеж (tuple) Список (list)
Как записывается (1, 2, 3) [1, 2, 3]
Можно менять элементы нет да
Методов (без служебных) 2: count, index 11
Может быть ключом словаря да, если внутри нет изменяемых объектов нет
Память на 6 чисел, sys.getsizeof 96 байт 104 байта
Создание из 6 чисел, записанных прямо в коде, 10 млн раз 0,023 с 0,204 с
Что обычно хранит одну запись из разных полей много однотипных элементов

Условия замера: Python 3.14, функция sys.getsizeof() показывает размер самого контейнера без учёта лежащих в нём чисел, время измерено модулем timeit (лучший из пяти прогонов).

Разница в памяти маленькая: 8 байт на объект. Разница в скорости создания заметнее, примерно в девять раз, но у неё простая причина. Кортеж из одних констант Python собирает один раз ещё при чтении кода и потом подставляет готовый объект, а список строит заново при каждом выполнении строки. Если кортеж собирается из переменных, выигрыш будет меньше.

Кортеж в Python это массив?

Массивом в Python обычно называют список или специальный модуль array, а кортеж ближе к записи из нескольких полей. В справке Python кортежи сравнивают со структурами из C и записями из Pascal, а списки с массивами других языков. Пример из той же справки: координаты точки удобно хранить кортежем из двух или трёх чисел.

Варианты «массивов» в Python и когда какой брать, показаны в статье «Массив в Python». Сам список со всеми методами подробно разобран в материале «Списки в Python».

Кортеж, множество и словарь

Четыре встроенные коллекции легко перепутать, поэтому коротко о двух оставшихся. Множество (set) хранит только уникальные элементы и не помнит порядок, зато быстро проверяет, есть ли в нём значение. Словарь (dict) хранит пары «ключ: значение».

Если нужен порядок и защита от изменений, берите кортеж. Нужна уникальность, подойдёт множество (о нём статья «Множества в Python»). Для поиска по ключу есть словарь.

Кортеж как ключ словаря

Связка ключей у стеклянной витрины с ячейками

Ключом словаря может быть только объект, у которого есть хеш: число, по которому словарь быстро находит нужную ячейку. Глоссарий Python объясняет, что неизменяемые контейнеры вроде кортежей хешируемы, только если хешируемы их элементы. Списки хеша не имеют вовсе.

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

coords = {(55.75, 37.62): 'Москва'}
print(coords[(55.75, 37.62)])
Москва

Но если внутри кортежа есть список, Python откажет и объяснит причину:

d = {(1, [2]): 'x'}
TypeError: cannot use 'tuple' as a dict key (unhashable type: 'list')

Как устроены словари, как перебирать ключи и значения, рассказано в статье «Словари в Python».

Именованные кортежи (namedtuple)

Обычный кортеж ('Аня', 25, 'Казань') неудобен тем, что через неделю непонятно, что лежит под индексом 2. Именованный кортеж даёт каждому полю имя. Его создают функцией namedtuple из модуля collections, в документации она описана как фабрика для подклассов кортежа с именованными полями.

from collections import namedtuple

Point = namedtuple('Point', 'x y')
p = Point(3, 4)
print(p)
print(p.x, p[0])
print(p._asdict())
print(p._replace(x=10))
Point(x=3, y=4)
3 3
{'x': 3, 'y': 4}
Point(x=10, y=4)

К полю можно обращаться и по имени, и по индексу. Метод _replace() возвращает новый кортеж с изменённым полем, старый остаётся как был. Метод _asdict() превращает запись в словарь, это удобно для вывода и сохранения.

CheckroiCheckroiПодборка курсов для Python-разработчиков88 курсов • 33 школыСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить→

Где кортежи встречаются в реальном коде

Даже если вы ни разу не писали круглые скобки сознательно, кортежи у вас в коде уже есть. Вот где они появляются чаще всего.

Функция возвращает несколько значений

Когда функция пишет return min(n), max(n), на самом деле она возвращает один кортеж, который потом удобно распаковать:

def stats(n):
    return min(n), max(n)

r = stats([4, 8, 1])
print(r, type(r))
low, high = stats([4, 8, 1])
(1, 8) <class 'tuple'>

Как устроены def, аргументы и return, показано в статье «Функции в Python».

Встроенные функции и методы

Многие стандартные инструменты отдают результат кортежами:

  • divmod(17, 5) возвращает (3, 2): частное и остаток (подробнее в статье про остаток от деления);
  • dict.items() отдаёт пары ключ и значение кортежами: [('a', 1)];
  • zip((1, 2), ('a', 'b')) склеивает последовательности в пары (1, 'a') и (2, 'b');
  • аргументы, собранные через *args, внутри функции лежат в кортеже.

Строки из базы данных

Модуль sqlite3 по умолчанию возвращает каждую строку таблицы кортежем. Запрос SELECT name, age FROM users вернёт что-то вроде ('Аня', 25). Тут кортеж совпадает со своим значением из баз данных: одна строка таблицы и есть кортеж.

Константы и настройки

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

Частые ошибки новичков

Забыть запятую в кортеже из одного элемента

t = ('abc') создаёт строку. Потом len(t) вернёт 3 вместо 1, и ошибка всплывёт далеко от места, где её сделали. Решение: ('abc',).

Ждать кортеж от генератора в скобках

Запись (x * 2 for x in (1, 2, 3)) похожа на кортеж, но создаёт генератор, который выдаёт значения по одному:

g = (n for n in range(3))
print(type(g))
print(tuple(x * 2 for x in (1, 2, 3)))
<class 'generator'>
(2, 4, 6)

Чтобы получить кортеж, оберните выражение в tuple(). Как работают генераторы, объяснено в статье про yield в Python.

Удивиться, что JSON вернул список

Формат JSON кортежей не знает. Модуль json записывает кортеж как список, и обратно вы получите уже список:

import json
print(json.dumps({'p': (1, 2)}))
print(json.loads(json.dumps((1, 2))))
{"p": [1, 2]}
[1, 2]

Если после загрузки нужен кортеж, преобразуйте вручную через tuple(). Запись и чтение JSON-файлов показаны в статье «Как записать данные в JSON-файл в Python».

Положить список в кортеж-ключ

Ошибка unhashable type: 'list' почти всегда значит, что где-то в ключе словаря или в элементе множества спрятан список. Замените его кортежем, и всё заработает.

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

Задачи для самопроверки

Три короткие задачи, чтобы закрепить тему. Ответы ниже, но сначала попробуйте сами в интерпретаторе.

  1. Что выведет print(type((7)), type((7,)))?
  2. Как одной строкой поменять местами значения переменных x и y?
  3. Как из кортежа (5, 3, 9) получить отсортированный кортеж?

Ответы: первая строка выведет <class 'int'> <class 'tuple'>; во второй задаче пишут x, y = y, x; в третьей tuple(sorted((5, 3, 9))) даст (3, 5, 9).

Ещё три десятка задач от ввода-вывода до функций собраны в подборке задач по Python для начинающих.

Где научиться Python

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

КурсШколаСтоимость со скидкойВ рассрочкуДлитель­ностьОбзор курса от Checkroi
Профессия «Python-разработчик»
Перейти на сайт курса
SkillboxSkillbox157 335 ₽5987 ₽/мес.10 месяцевОбзор курса
Fullstack-разработчик на Python
Перейти на сайт курса
НетологияНетология137 000 ₽7125 ₽/мес.21 месяцОбзор курса
ДО Профессия Python-разработчик
Перейти на сайт курса
GeekBrainsGeekBrains149 001 ₽3167 ₽/мес.10 месяцевОбзор курса
Автоматизированное тестирование на Python
Перейти на сайт курса
SkillboxSkillbox118 754 ₽4108 ₽/мес.9 месяцевОбзор курса
Профессия Python-разработчик
Перейти на сайт курса
SkillFactorySkillFactory140 040 ₽3890 ₽/мес.10 месяцевОбзор курса
Разработчик на Python
Перейти на сайт курса
НетологияНетология175 000 ₽5500 ₽/мес.6 месяцевОбзор курса
Профессия «Python-разработчик с нуля до трудоустройства»
Перейти на сайт курса
НетологияНетология81 800 ₽5500 ₽/мес.6 месяцевОбзор курса
Профессия Fullstack-разработчик на Python
Перейти на сайт курса
SkillFactorySkillFactory158 040 ₽4390 ₽/мес.16 месяцевОбзор курса
Python-разработчик + ИИ
Перейти на сайт курса
Академия СинергияАкадемия Синергия77 900 ₽3246 ₽/мес.6 месяцевОбзор курса
Python-фреймворк Django
Перейти на сайт курса
SkillboxSkillbox58 396 ₽5128 ₽/мес.3 месяцаОбзор курса

Больше программ — в полном каталоге курсов по Python

Если вы выбираете, куда расти с Python дальше, посмотрите разбор профессии Python-разработчика и пошаговый план из статьи «Как стать Python-разработчиком с нуля».

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

Что такое кортеж в Python простыми словами?

Кортеж (tuple) — упорядоченный набор значений, который нельзя изменить после создания. Записывается в круглых скобках через запятую: ('Аня', 25, 'Казань'). Обычно в кортеже хранят одну запись из нескольких полей, например координаты точки или строку из таблицы.

Как создать кортеж из одного элемента?

Поставить запятую после значения: (5,) или просто 5,. Запись (5) без запятой Python считает обычным числом в скобках, и type((5)) вернёт int.

Как добавить элемент в кортеж?

Изменить существующий кортеж нельзя, но можно собрать новый: b = a + (4,). Если правок много, превратите кортеж в список через list(), измените его и соберите обратно через tuple().

Чем кортеж отличается от списка в Python?

Список можно менять, кортеж нельзя. У кортежа два метода (count и index), у списка 11. Кортеж из неизменяемых значений может быть ключом словаря, список не может. Подробное сравнение списков есть в статье «Списки в Python».

Как превратить список в кортеж и обратно?

Функцией tuple(): tuple([1, 2]) вернёт (1, 2). Обратно работает list(): list((1, 2)) вернёт [1, 2].

Какие методы есть у кортежа?

Только два: count(x) считает, сколько раз элемент встречается, а index(x) возвращает номер его первого вхождения. Остальные действия делают встроенные функции: len(), min(), max(), sum(), sorted().

Можно ли отсортировать кортеж?

На месте нельзя. Функция sorted() вернёт отсортированный список, а чтобы снова получить кортеж, оберните его в tuple(): tuple(sorted((3, 1, 2))) даст (1, 2, 3).

Что такое распаковка кортежа?

Это запись элементов кортежа в отдельные переменные одной строкой: name, age = ('Аня', 25). Переменных должно быть столько же, сколько элементов, иначе будет ValueError. Лишние элементы можно собрать звёздочкой: first, *rest = (1, 2, 3).

Читайте Checkroi первым в Google
Добавьте Checkroi в избранные источники — и наши разборы курсов и обзоры школ будут показываться выше в вашей выдаче Google.
Оставить комментарий
0 комментариев
Форма комментария

Оставьте комментарий

Напишите, что думаете. Нам важно ваше мнение!