Как запустить Python-скрипт

Рука держит руководство по Python для начинающих

Иметь чёткое представление о вариантах запуска Python-скрипта полезно — это ускоряет работу и помогает избегать распространённых ошибок. Запускать скрипты можно множеством способов. В этой статье мы подробно рассмотрим каждый из них, добавим практические советы, шаблоны и контрольные списки.

Что нужно, чтобы запустить Python-скрипт

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

Установлен Python: откройте официальный сайт Python и скачайте последнюю стабильную версию, если её нет.
Есть редактор кода или IDE: например VS Code, PyCharm, Sublime Text.
Python добавлен в системную переменную PATH, чтобы вы могли запускать его из командной строки.

Чтобы узнать, установлен ли Python и добавлен ли он в PATH, выполните в терминале:

python --version

Если терминал ответит версией Python, то всё готово. На Windows также часто доступен лаунчер py:

py -3 --version

Важно: в системах с несколькими версиями Python лучше явно указывать версию (python3, py -3 и т. п.).

Быстрые определения

Python: язык программирования высокого уровня.
Скрипт: файл с кодом Python, обычно с расширением .py.
Модуль: файл .py, который можно импортировать в другой файл.
Виртуальное окружение (venv): изолированная среда с собственными зависимостями.

Как запустить Python интерактивно

Интерактивный режим позволяет выполнять отдельные выражения или тестировать фрагменты кода прямо в терминале.

Откройте терминал (Command Prompt, PowerShell, Terminal).
Введите:

python

или если нужно явно Python 3:

python3

Пишите выражения и нажимайте Enter — результат появится сразу.

Интерактивный режим удобен для проверки идей, вычислений и небольших экспериментов. Но код в нём нестабилен: при закрытии терминала всё, что не сохранено, теряется. Для выхода используйте:

exit()

или на Windows Ctrl+Z, затем Enter; на macOS/Linux Ctrl+D.

Важно: в интерактивном режиме тяжело писать большие блоки кода с отступами. Для функций и классов используйте аккуратные отступы или пишите их в файле .py и импортируйте.

Запуск .py файла через команду python

Самый распространённый способ — сохранить код в файле с расширением .py и вызвать python из терминала.

Шаги:

Создайте файл, например myFile.py.
Откройте его в редакторе и напишите код.
Сохраните файл.
В терминале перейдите в папку с файлом:

cd путь/к/папке

Выполните:

python myFile.py

Если на системе несколько интерпретаторов, используйте python3 или py -3.

Чтобы сохранить вывод в файл, перенаправьте stdout:

python myFile.py > output.txt

Полезно при запуске долгих задач и логировании.

Запуск файла по его имени

На современных Windows, если у вас настроено сопоставление .py с интерпретатором, достаточно ввести имя файла:

myFile.py

Однако поведение зависит от системных ассоциаций файлов и от настроек PATH.

Запуск через IDE

IDE (интегрированные среды разработки) упрощают работу с проектами. Они управляют виртуальными окружениями, подсветкой, отладкой и запуском из графического интерфейса.

Популярные IDE и их особенности:

PyCharm: мощный инструмент для больших проектов, интегрированный отладчик и управление виртуальными окружениями.
VS Code: лёгкий редактор с расширениями для Python, интеграция с терминалом и отладчиком.
Spyder: ориентирован на анализ данных и научные вычисления.

В большинстве IDE запуск — одна кнопка. IDE также умеют запускать конфигурации с аргументами командной строки, переменными среды и привязкой к интерпретатору.

Браузерные среды: Jupyter и Google Colab

Ячейки кода в Google Colab

Jupyter Notebook и Google Colaboratory позволяют писать код в ячейках. Это удобно для анализа данных, визуализации и пошаговой демонстрации.

В Jupyter Notebook вы устанавливаете пакет jupyter и запускаете jupyter notebook.
В Google Colab достаточно открыть браузер и создать новый ноутбук.

Запуск ячейки: Ctrl+Enter. Ячейки сохраняются, поэтому вы не потеряете прогресс.

Важно: Colab работает в облаке и требует подключения к интернету, но позволяет использовать GPU/TPU и делиться ноутбуками.

Использование встроенного IDLE

Интерфейс Python IDLE

IDLE — простая среда от разработчиков Python. Подходит для быстрых экспериментов и обучения. Откройте IDLE через меню Пуск или командой idle в терминале.

В IDLE можно писать код и запускать отдельные строки или файл целиком через File → Save as, а затем Run → Run Module (F5).

Запуск скрипта как модуля из другого Python-файла

Иногда нужно запустить один скрипт внутри другого. Вот основные способы.

Импорт как модуль

Если myScript.py и вызывающий файл находятся в одной папке, можно просто импортировать модуль:

import myScript

При импорте выполнится код сверху уровня модуля. Чтобы запускать код только при прямом запуске, в myScript.py используйте защиту:

if __name__ == "__main__":
    main()

Это стандартный шаблон: код в этом блоке выполняется только при запуске файла как скрипта, но не при импорте.

Импорт конкретных объектов

Если нужны только функции или классы:

from myScript import myFunction
myFunction()

exec для выполнения файла как кода

exec(open('myScript.py').read())

exec выполняет код в текущем пространстве имён. Используйте осторожно — это потенциальный риск безопасности.

runpy

Модуль runpy позволяет запустить модуль по имени:

import runpy
runpy.run_module('myScript')

Или запустить по пути:

runpy.run_path('myScript.py')

importlib

importlib полезен для динамического импорта:

import importlib
importlib.import_module('myScript')

Этот метод возвращает объект модуля и позволяет перезагружать модули во время выполнения.

Запуск двойным кликом и особенности

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

input('Нажмите Enter для выхода...')

Или используйте бесконечный цикл (менее чистый способ):

while True:
    pass

Лучше добавлять input, чтобы программа корректно завершалась.

Запуск с опциями интерпретатора

Python поддерживает флаги командной строки, которые меняют поведение:

-m: запуск модуля как скрипта (python -m http.server)
-c: выполнить команду из строки (python -c “print(‘hi’)”)
-u: небуферизованный ввод/вывод
-O: оптимизированный режим (генерирует файлы .pyo в старых версиях)
-B: не записывать файлы .pyc

Пример запуска встроенного HTTP-сервера:

python -m http.server 8000

Работа с виртуальными окружениями

Виртуальное окружение (venv) изолирует зависимости проекта. Рекомендуется иметь по одному venv на проект.

Создание и активация venv:

python -m venv venv
# Windows
venv\Scripts\activate
# macOS/Linux
source venv/bin/activate

После активации python указывает на интерпретатор внутри venv и вы можете устанавливать пакеты через pip без влияния на системный Python.

Запуск в контейнерах и как сервис

Для развёртывания часто используют Docker или системные службы.

Dockerfile пример:

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt ./
RUN pip install -r requirements.txt
COPY . ./
CMD ["python", "app.py"]

Системные службы (systemd) позволяют запускать скрипт как фоновую службу на Linux. Это удобно для серверных приложений.

Планирование задач: cron и Планировщик заданий Windows

Запускайте Python-скрипты по расписанию.

Пример записи cron (каждый день в 3:00):

0 3 * * * /usr/bin/python3 /home/user/myScript.py >> /var/log/myscript.log 2>&1

Пример для Windows Task Scheduler: создайте задачу, укажите путь к python.exe и аргументы с путем к скрипту.

Полезные сценарии: логирование, перехват ошибок и отладка

Всегда подключайте логирование вместо print для серверных приложений:

import logging
logging.basicConfig(level=logging.INFO, filename='app.log')
logging.info('Запуск приложения')

Используйте try/except для аккуратной обработки исключений и записи их в логи.
Для интерактивной отладки применяйте pdb, breakpoint() или отладчик IDE.

Советы по совместимости и миграции между версиями

Проверяйте, какой интерпретатор используется: python, python3, py -3.
Для перехода с Python 2 на Python 3 используйте инструмент 2to3 (только при необходимости).
Библиотеки могут иметь ограничения по версиям — читайте документацию и используйте requirements.txt или poetry для фиксации зависимостей.

Когда способы не подойдут (контрпримеры)

Если скрипт требует GUI и вы запускаете его на headless-сервере, программа не отобразится.
При явных зависимостях на локальные файлы запуск в контейнере без правильного монтирования даст ошибки.
Запуск exec с непроверенным кодом — риск безопасности.

Шпаргалка команд (cheat sheet)

# Запуск файла
python myFile.py
# Запуск с конкретной версией
python3.11 myFile.py
# Запуск модуля
python -m mypackage.mymodule
# Выполнение команды
python -c "print('hello')"
# Сохранить вывод
python myFile.py > out.txt 2>&1
# Виртуальное окружение
python -m venv venv
source venv/bin/activate
# Запуск в фоне через nohup
nohup python myFile.py &

Контрольные списки

Общий чек-лист перед запуском скрипта в продакшене:

Проверил версию Python
Активировал виртуальное окружение
Установил зависимости (pip install -r requirements.txt)
Настроил логирование
Проверил права доступа к файлам и сетевым ресурсам
Написал обработку ошибок и таймауты
Настроил мониторинг и перезапуск (systemd, supervisor, Docker restart)

Рекомендации по ролям:

Разработчик:
- Использует venv, линтеры и тесты.
- Упаковывает зависимые библиотеки в requirements.txt или poetry.lock.
Девопс/Системный администратор:
- Настраивает systemd/cron/Task Scheduler.
- Контейнеризует приложение и настраивает CI/CD.
Аналитик данных:
- Предпочитает Jupyter/Colab для итеративной работы.
- Экспортирует результаты в CSV/Parquet.

Ментальные модели и эвристики

Малые эксперименты → интерактивный режим.
Исследование и документирование → Jupyter/Colab.
Постоянный сервер и критичность работы → systemd/Docker и мониторинг.
Многопользовательская разработка → виртуальные окружения и менеджеры зависимостей.

Безопасность и приватность

Не запускайте код из непроверенных источников.
Храните секреты (API-ключи, пароли) в переменных окружения, а не в коде.
Для облачных сред используйте менеджеры секретов.

Критерии приёмки

Перед тем как пометить задачу как выполненную, убедитесь:

Скрипт запускается без ошибок на целевой машине.
Логи понятны и содержат достаточный контекст для диагностики.
Скрипт корректно завершается или управляется системой перезапуска.
Тесты, покрывающие критическую логику, проходят успешно.

Глоссарий (одно предложение каждой записи)

Интерпретатор: программа, выполняющая байт-код Python.
Модуль: файл .py, который можно импортировать.
Виртуальное окружение: локальная копия интерпретатора и библиотек для проекта.

Локальные заметки и совместимость для России

На локальных машинах Windows часто удобен лаунчер py. Команда py -3 запускает последнюю установленную версию Python 3.
Для развёртывания на российских серверах проверьте доступность образов Docker и зеркал PyPI; при ограничениях используйте локальные зеркала.

Примеры сценариев и тесты приёмки

Пример теста: скрипт myFile.py выводит строку “OK” и завершается с кодом 0.

Критерии приёмки:

При запуске python myFile.py stdout содержит “OK”.
Код завершения процесса равен 0.

Итоговая сводка

Важно выбрать способ запуска, который соответствует задаче: интерактивный режим для быстрых экспериментов, IDE и Jupyter для разработки и анализа, systemd/Docker для продакшена. Всегда используйте виртуальные окружения, логирование и управление зависимостями. Тестируйте сценарии запуска и автоматизируйте развёртывание.

Важно: никогда не выполняйте посторонний код без проверки. Сохраняйте секреты вне репозитория и документируйте команду запуска для вашей команды.

Краткое резюме:

Понимайте различия между запуском как файла, как модуля и интерактивным режимом.
Настраивайте окружения и автоматизацию для надёжности.
Используйте правильные инструменты для вашей роли и задачи.

Как запустить Python-скрипт — все способы и лучшие практики