
Python Launcher установлен по умолчанию вместе с официальным дистрибутивом Python для Windows и обозначается как py.exe. Он позволяет запускать разные версии Python без изменения переменных среды или удаления предыдущих установок.
Если на компьютере установлены Python 3.11 и Python 3.9, команда py запустит версию, назначенную по умолчанию, а py -3.9 – конкретный релиз. Такой контроль особенно полезен при тестировании программ или управлении проектами с разными требованиями.
Launcher анализирует shebang-строки в файлах, например # ! python3 или # ! python3.10, и запускает соответствующую версию интерпретатора. Это избавляет от привязки файлов к конкретному пути установки Python и помогает избежать конфликтов при обновлениях.
Для проверки наличия Python Launcher можно выполнить команду py —version в PowerShell или командной строке. Если он установлен корректно, система вернёт текущую активную версию интерпретатора.
Назначение Python Launcher в Windows и его роль в управлении версиями
Python Launcher служит интерфейсом между установленными версиями Python и пользователем. Он запускает интерпретатор через команду py, определяет доступные версии и использует конфигурацию системы, чтобы выбрать нужный релиз.
Launcher упрощает работу в среде, где установлено несколько версий Python. Например, командой py -3.12 можно открыть Python 3.12, а py -2 – Python 2.7, если он установлен. При этом无需 изменять переменные PATH или переименовывать исполняемые файлы.
Файл py.ini позволяет задать интерпретатор по умолчанию. Если в конфигурации указан параметр default=3.11, команда py будет запускать именно его. Такой подход снижает вероятность конфликтов при обновлении Python или работе с проектами, требующими строгой версии.
Launcher также поддерживает распознавание shebang-строк в скриптах, например: # ! python3.10. Это обеспечивает независимость скриптов от конкретного пути Python и делает их переносимыми.
Где находится Python Launcher и как проверить его наличие

Исполняемый файл Python Launcher размещается в каталоге C:\Windows под именем py.exe. В некоторых системах присутствует дополнение pyw.exe, предназначенное для запуска приложений без консольного окна.
Команда where py поможет определить физический путь к запускателю. Если в результате указан каталог C:\Windows, система использует стандартный путь установки. При наличии нескольких путей стоит проверить конфигурацию и удалить дубликаты, так как они могут вызывать конфликт при вызове интерпретатора.
Если Launcher отсутствует, его можно установить вместе с официальным дистрибутивом Python, отметив пункт «Add Python Launcher for Windows» в процессе установки.
Запуск Python через py.exe: базовые команды и их назначение
Python Launcher использует короткий вызов py для управления запуском интерпретатора и выполнения скриптов. Команды применяются как в PowerShell, так и в командной строке.
- py – запускает установленную версию по умолчанию.
- py —version – отображает текущую версию, используемую Launcher.
- py script.py – выполняет конкретный файл с использованием версии по умолчанию.
- py -3.11 script.py – запускает файл с указанной версией интерпретатора.
- py -m pip install package – вызывает pip через выбранную версию Python.
Если требуется выполнить код напрямую, без скриптов, используется режим ввода:
- py -3 – открывает интерактивный REPL Python 3.
- py -X utf8 – запускает интерпретатор в режиме UTF-8, что полезно при работе с русским текстом.
Команды помогают управлять версиями, тестировать код и устанавливать зависимости без изменения PATH или замены системных настроек.
Использование ключей py -2, py -3 и выбор версии Python при запуске

Ключи -2 и -3 позволяют вызвать нужную ветку Python без изменения настроек системы. Команда py -3 открывает последнюю найденную версию Python 3, а py -2 – установленный Python 2, если он присутствует в системе.
Для запуска конкретного релиза используется уточнение версии через десятичную форму. Примеры:
- py -3.10 – запуск Python 3.10;
- py -3.12 script.py – выполнение файла через Python 3.12;
- py -2.7 – вызов Python 2.7 при наличии данной версии.
Чтобы проверить доступные версии, используется команда py -0 или py -0p. Вторая модификация дополнительно показывает пути к каждому интерпретатору. Если нужная версия не отображается, стоит проверить установку или изменить конфигурационный файл py.ini.
Комбинация версии и вызова модулей позволяет запускать инструменты для определённого интерпретатора. Например, команда py -3.11 -m pip list покажет пакеты, установленные только для Python 3.11, а не для остальных версий.
Настройка shebang строк для автоматического выбора версии Python

Python Launcher анализирует первую строку файла и выбирает интерпретатор по указанной инструкции. Такая строка начинается с символов #! и содержит название версии или путь к Python. Это позволяет запускать скрипт без выбора версии вручную.
Примеры shebang строк:
- #! python3 – запуск через текущую доступную версию Python 3.
- #! python3.11 – выполнение через конкретную версию Python 3.11.
- #! python2 – принудительный запуск через Python 2, если он установлен.
В Windows не требуется указывать полный путь вроде #! C:\Python311\python.exe, поскольку Python Launcher сам определяет расположение установленного интерпретатора. Это повышает переносимость скриптов при изменении директорий или при работе на разных устройствах.
Если shebang отсутствует, Launcher использует версию по умолчанию. Изменить поведение можно через файл py.ini. Например, строка default=3.11 назначит Python 3.11 базовым вариантом для всех файлов без shebang-инструкции.
Типичные ошибки при использовании Python Launcher и способы их устранения
При работе с Python Launcher часто возникают ошибки, связанные с отсутствием интерпретатора, конфликтами версий или неправильными shebang строками. Ниже представлены распространённые ситуации и рекомендации по их исправлению.
| Ошибка | Причина | Решение |
|---|---|---|
| py: команда не найдена | Launcher не установлен или отсутствует в каталоге C:\Windows | Переустановить Python, отметив пункт «Add Python Launcher for Windows» |
| Запуск через py -3.10 не выполняется | Указанная версия Python не установлена или путь к ней не зарегистрирован | Установить нужную версию Python или проверить пути в py.ini |
| Ошибка при выполнении скрипта с shebang | Некорректная версия в строке #! или лишние пробелы | Исправить shebang на допустимый вид, например #! python3.11 |
| Конфликт версий pip | Запуск py -m pip использует не ту версию Python | Указывать конкретную версию: py -3.11 -m pip install package |
Дополнительно рекомендуется проверять список доступных версий командой py -0 перед запуском скриптов и тестировать ключи -2 или -3 для подтверждения корректного выбора интерпретатора.
Вопрос-ответ:
Что такое Python Launcher и зачем он нужен на Windows?
Python Launcher — это отдельный исполняемый файл py.exe, который устанавливается вместе с Python на Windows. Он позволяет запускать разные версии Python без изменения переменных PATH. Благодаря нему можно использовать одну команду для выбора нужной версии интерпретатора и выполнения скриптов с конкретной версией Python.
Как проверить, установлен ли Python Launcher на компьютере?
Для проверки нужно открыть командную строку или PowerShell и выполнить команду py —version. Если Launcher установлен, будет отображена версия Python по умолчанию. Также можно использовать команду where py, которая покажет точное расположение файла py.exe в системе.
Как запускать конкретную версию Python с помощью py.exe?
Для выбора версии используется ключ -2 для Python 2 и -3 для Python 3. Можно указать точный релиз, например py -3.11 script.py запустит скрипт через Python 3.11. Это позволяет одновременно работать с несколькими версиями Python без изменения системных настроек.
Что делает shebang строка и как её правильно использовать в Windows?
Shebang строка в начале скрипта, например #! python3.10, сообщает Launcher, какую версию Python использовать. Она делает скрипт переносимым и избавляет от необходимости вручную указывать интерпретатор. В Windows путь к Python указывать необязательно — Launcher сам находит установленный интерпретатор.
Какие ошибки возникают при работе с Python Launcher и как их исправить?
Частые ошибки включают отсутствие Launcher (py: команда не найдена), запуск через несуществующую версию Python, некорректный shebang и конфликты pip. Решения: переустановить Launcher, проверить установленные версии через py -0, исправить shebang на допустимый вид, использовать ключи с указанием версии для pip, например py -3.11 -m pip install package.
