Jet School Logo

Что такое Аннотации функций?

Аннотации функций (Function Annotations, подсказки типов) в Python — это способ указать, каких типов должны быть параметры функции и возвращаемое значение. Они повышают читаемость, понятность и самодокументируемость кода, особенно в больших проектах.

Важно понимать: аннотации — это только подсказки, Python сам не проверяет во время выполнения, соблюдаются ли они.

Проще говоря: аннотация похожа на этикетку на коробке. Надпись «Только для книг» помогает тому, кто её читает, но если кто-то положит в коробку игрушку, коробка этому не помешает.

Краткая история

Python — язык с динамической типизацией: тип переменной заранее не объявляется. Аннотации функций появились в Python 3.0 (PEP 3107). А в 2014 году вместе с Python 3.5 (PEP 484) был определён стандартный способ их использования для типов — type hints.

Синтаксис

Тип параметра указывается после его имени через двоеточие, а тип результата — после скобок через стрелку (->). Например: def imya_funktsii(parametr1: tip1, parametr2: tip2) -> tip_vozvrata:

  • parametr1: tip1 — ожидаемый тип параметра parametr1.
  • -> tip_vozvrata — тип значения, которое вернёт функция.

Пример

Функция def slozhit(a: int, b: int) -> int: показывает, что параметры a и b — целые числа (int), и результат тоже будет целым числом.

Но если написать slozhit(“5”, “7”), Python не выдаст ошибку, и результатом будет «57»: две строки просто склеятся. То есть даже при наличии аннотаций Python не проверяет типы. Подробнее — на странице о типах данных.

Чтобы найти такие ошибки ещё до запуска программы, используют специальные инструменты проверки типов (type checker) — например, mypy и pyright. Они анализируют код и выдают предупреждения вроде «здесь ожидался int, а передаётся строка».

Сложные типы

С помощью аннотаций можно описывать и более сложные типы:

Например, функция def statistika(dannye: list[int]) -> tuple[int, int]: принимает список чисел и возвращает его длину и сумму.

Примечание: в версиях до Python 3.9 для этого использовались List, Tuple, Dict из модуля typing. В старом коде они встречаются до сих пор.

Значение, которое может отсутствовать: если функция иногда ничего не возвращает (None), начиная с Python 3.10 это записывается как str | None. Это значит: «результат будет строкой или ничем».

Аннотации переменных

Аннотации можно использовать не только в функциях, но и для обычных переменных. Например, запись vozrast: int = 14 показывает, что переменная «vozrast» — целое число.

Практическое применение

  • Повышает читаемость: по одному взгляду на функцию понятно, что ей передать и что она вернёт.
  • IDE становятся умнее: PyCharm и VS Code на основе аннотаций предлагают автодополнение и предупреждают о несоответствии типов.
  • Облегчает командную работу: проще разобраться в чужом коде.
  • Предотвращает ошибки: вместе с инструментами проверки типов многие баги находятся ещё до запуска программы.
  • Используется библиотеками: такие инструменты, как FastAPI, Pydantic и dataclasses, читают аннотации во время выполнения — например, чтобы автоматически проверять входящие данные или генерировать документацию API.

Аннотации и Duck Typing

По философии Python важнее не тип объекта, а то, что он умеет делать, — этот подход называется Duck Typing. Аннотации не отменяют эту гибкость: это не обязательное правило, а полезная подсказка для программистов и инструментов.

Хотите применить эти знания на практике и получить реальные результаты? Начните обучение на курсе «IT и Компьютерная инженерия» и шаг за шагом приобретайте практические навыки. Подробнее о курсе — перейдите по ссылке: Курс «IT и Компьютерная инженерия».

Заполните форму чтобы узнать больше о наших IT курсах

Связанные термины:

Начни изучать IT уже сегодня