Python: полный мануал с примерами и справочником функций

Глава 0 · начальный

Как пользоваться руководством и что умеет Python

Выбрать учебный маршрут и выполнить первый понятный пример.

Начните с небольшой программы, которую можно полностью объяснить. В ней достаточно нескольких строк: сохранить данные, выполнить расчёт и показать ответ. Такое начало помогает отличить понимание языка от умения запустить большой чужой проект. В этом руководстве основной проверенный интерпретатор — Python 3.15.0. Версия важна: новое имя или синтаксис может отсутствовать в Python, который уже стоит на вашем компьютере.

Первый результат: код и вывод

Сохраните следующий текст в файле hello.py и запустите его способом из главы об установке. Не добавляйте в файл обозначения вывода и стрелки приглашения терминала. Имя name связывается со строкой, lessons — с числом. Вызов print() отправляет текст в стандартный вывод: в обычном запуске он виден в терминале.

name = "Анна"
lessons = 3
print(f"Привет, {name}!")
print(f"Сегодня пройдено тем: {lessons}")

Привет, Анна!
Сегодня пройдено тем: 3

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

Python, CPython и ваша программа

Python — язык с правилами записи и поведения программ. CPython — его основная реализация, которую вы обычно скачиваете с python.org. Интерпретатор читает программу и выполняет её согласно этим правилам. Другие реализации могут отличаться скоростью, средой и поддержкой возможностей; для повседневного обучения важно сначала знать, какой интерпретатор выбран вашим редактором.

Расширение .py сообщает человеку и инструментам тип файла, но само не устанавливает Python и не выбирает окружение. Сохранённый файл может лежать в правильной папке, а команда python — запускать другое установленное окружение. Поэтому проверка версии и пути sys.executable входит в начало каждого проекта, а не только в первоначальную установку.

Где Python полезен и что нужно дополнительно

Python подходит для обработки текстов и таблиц, подготовки отчётов, автоматизации файловых операций, серверных приложений и научных расчётов. Например, программа может проверить строки выгрузки, сгруппировать заявки по статусам и записать результат в CSV. Язык даёт условия, циклы и функции; конкретные форматы и сетевые протоколы обслуживают библиотеки.

Различайте три уровня. Встроенная функция len() доступна сразу. Модуль стандартной библиотеки csv обычно входит в установленный Python, но его нужно импортировать. Сторонний пакет ставится отдельно в окружение проекта. Ошибка ModuleNotFoundError у стороннего пакета не означает, что язык сломан: пакет может просто отсутствовать в выбранном окружении.

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

Скрипт, REPL и ячейки

Скрипт удобен, когда результат нужно повторить: исходник сохранён, запуск выполняет весь файл. REPL — интерактивная оболочка для коротких проверок. Введите выражение, получите значение, попробуйте следующее. Приглашение >>> принадлежит оболочке и не копируется в скрипт. Для выхода обычно используют exit(); сочетания клавиш зависят от системы и терминала.

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

Как выбрать маршрут по руководству

Если начинаете с нуля, идите от установки к синтаксису, числам, строкам и коллекциям. После условий и функций попробуйте маленькую задачу с файлами. Не требуйте от себя запоминания всех методов. Полезнее уметь сформулировать действие: найти подстроку, отсортировать записи, прочитать JSON. По такому действию проще найти подходящую главу и справочное имя.

Если задача уже есть, сначала опишите её вход и желаемый результат. Для списка заказов это могут быть строки с ценой и количеством, для отчёта — суммарная стоимость и список ошибок. Затем разбейте путь на шаги: прочитать, проверить, преобразовать, сохранить. Обращайтесь к конкретным главам по мере необходимости; справочник функций дополняет объяснение, но не заменяет проверку примера на ваших данных.

Как читать результат и ошибку

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

text = "не число"
try:
    count = int(text)
except ValueError as error:
    print(type(error).__name__)
    print("Количество должно быть записано цифрами")

ValueError
Количество должно быть записано цифрами

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

Упражнение: понятный отчёт о результате

Измените первый пример: задайте две переменные, planned и finished, вычислите количество оставшихся тем и напечатайте его. Проверьте случай, когда все темы уже пройдены. Ожидаемый результат — ноль оставшихся тем, а не сообщение об ошибке. Объясните своими словами, где программа хранит число и где превращает его в текст.

planned = 5
finished = 5
remaining = planned - finished
print(f"Осталось тем: {remaining}")

Осталось тем: 0

Первичные ориентиры: официальный учебник Python и страница загрузки. Проверенная версия относится к состоянию руководства на 12 октября 2026 года; для другого установленного Python сверяйте пометки рядом с новыми возможностями.