
Аннотации функций (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:
Функция 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» — целое число.
По философии Python важнее не тип объекта, а то, что он умеет делать, — этот подход называется Duck Typing. Аннотации не отменяют эту гибкость: это не обязательное правило, а полезная подсказка для программистов и инструментов.
Хотите применить эти знания на практике и получить реальные результаты? Начните обучение на курсе «IT и Компьютерная инженерия» и шаг за шагом приобретайте практические навыки. Подробнее о курсе — перейдите по ссылке: Курс «IT и Компьютерная инженерия».