Ошибка «py не является внутренней или внешней командой, исполняемой программой или пакетным файлом» появляется в командной строке Windows, когда система не находит Python Launcher — утилиту py.exe, отвечающую за запуск интерпретатора. Чаще всего причина в том, что Python установлен без компонента Launcher, либо путь к нему отсутствует в переменной окружения PATH.
Проблема решается без переустановки системы: достаточно проверить наличие Python, исправить переменные окружения или использовать альтернативную команду запуска. Ниже разберём диагностику по шагам и все рабочие способы устранения ошибки.
Почему возникает ошибка с командой py
Команда py — это не сам интерпретатор Python, а отдельный лаунчер, который устанавливается вместе с официальным дистрибутивом с сайта python.org. Он позволяет выбирать версию Python при запуске, например py -3.11 script.py. Если лаунчер не установлен или Windows не знает, где он лежит, вы получаете именно эту ошибку.
Типичные причины:
- 🔧 Python установлен без галочки py launcher в установщике — компонент отключается вручную.
- 📁 Путь к папке с
py.exe(обычноC:\Windows) не прописан в PATH. - 🐍 Python установлен из Microsoft Store — там лаунчер
pyможет отсутствовать, доступна только командаpython. - ⚙️ Установка выполнена «для текущего пользователя», а терминал запущен от другого пользователя или с особыми правами.
- 🗑️ Файл
py.exeудалён или повреждён антивирусом либо чистильщиком системы.
Шаг 1. Проверьте, установлен ли Python вообще
Прежде чем чинить лаунчер, убедитесь, что интерпретатор присутствует в системе. Откройте командную строку (Win + R → cmd) и выполните по очереди:
python --version
py --version
where python
where py
Если python --version выводит номер версии, а py не работает — проблема только в лаунчере, и можно либо пользоваться командой python, либо доустановить Launcher. Если не работает ни одна команда, переходите к проверке PATH или переустановке.
Команда where py покажет, видит ли система файл py.exe. Пустой ответ означает, что лаунчер не установлен или его путь не прописан.
Шаг 2. Проверьте и исправьте переменную PATH
Переменная окружения PATH сообщает Windows, в каких папках искать исполняемые файлы. Если пути к Python там нет, система честно сообщает, что команда ей неизвестна.
Порядок действий:
- 🖥️ Нажмите
Win + R, введитеsysdm.cplи откройте вкладку «Дополнительно». - 🔍 Нажмите «Переменные среды» и найдите
Pathв списке пользовательских или системных переменных. - ➕ Проверьте наличие путей вида
C:\Users\Имя\AppData\Local\Programs\Python\Python312\и подпапкиScripts\. - 💾 Добавьте недостающие пути, сохраните изменения и перезапустите командную строку — открытые окна терминала не подхватывают новые значения.
⚠️ Внимание: редактируйте PATH аккуратно и не удаляйте существующие записи других программ. Перед изменением скопируйте текущее значение переменной в текстовый файл — это позволит откатить правку, если что-то пойдёт не так.
☑️ Проверка PATH для Python
Шаг 3. Доустановите Python Launcher
Если лаунчер не был установлен, проще всего запустить установщик Python повторно. Скачивать ничего заново не нужно, если установочный файл сохранился: запустите его и выберите Modify. В списке компонентов отметьте py launcher и завершите установку.
При чистой установке обратите внимание на первый экран установщика: там есть опция Add python.exe to PATH — её включение избавляет от ручной правки переменных окружения. Лаунчер при стандартной установке копируется в системную папку C:\Windows, которая и так входит в PATH, поэтому py начинает работать сразу.
Сравнение способов решения
Выбор метода зависит от того, что именно сломано. Сводная таблица поможет сориентироваться:
| Ситуация | Решение | Сложность |
|---|---|---|
| python работает, py — нет | Использовать команду python или доустановить Launcher через Modify | Низкая |
| Python установлен, но обе команды не работают | Добавить пути в PATH вручную | Средняя |
| Python из Microsoft Store | Пользоваться python или установить версию с python.org | Низкая |
| Python не установлен | Чистая установка с включёнными py launcher и PATH | Низкая |
| py.exe удалён или повреждён | Повторный запуск установщика, пункт Repair | Низкая |
Особенности Python из Microsoft Store
Версия Python, установленная через Microsoft Store, устроена иначе: она размещается в изолированном каталоге и не включает классический лаунчер py. Поэтому команда py в этом случае может не работать даже при полностью исправной системе — это особенность дистрибутива, а не поломка.
Дополнительный нюанс: в Windows существуют «псевдонимы выполнения приложений» (App execution aliases), которые перенаправляют команды python и python3 в Microsoft Store, если Python не установлен. Если вы вводите команду, а вместо интерпретатора открывается магазин — проверьте раздел Параметры → Приложения → Расширенные параметры приложений → Псевдонимы выполнения приложения и при необходимости отключите переключатели для Python. Точные названия пунктов могут отличаться в зависимости от версии Windows.
⚠️ Внимание: не удаляйте системные файлы и не правьте реестр, пытаясь «вернуть» команду py вручную. Безопасный путь — официальный установщик с python.org с включённым компонентом py launcher.
Как запустить скрипт без команды py
Откройте командную строку в папке со скриптом (введите cmd в адресной строке Проводника) и выполните python имя_файла.py. Либо укажите полный путь к интерпретатору: "C:\Users\Имя\AppData\Local\Programs\Python\Python312\python.exe" script.py. Также скрипт можно запустить двойным кликом, если файлы .py ассоциированы с Python.
Как проверить, что проблема решена
После любого из исправлений закройте все окна терминала и откройте командную строку заново — это обязательное условие, потому что переменные окружения считываются при запуске. Затем выполните:
py --version
py -0
Первая команда должна вывести версию Python, вторая — список всех установленных версий, которые видит лаунчер. Если обе отрабатывают без ошибок, лаунчер py полностью работоспособен, и можно запускать скрипты привычной командой py script.py.
Если ошибка сохраняется, проверьте, не запущен ли терминал от имени другого пользователя, и повторите диагностику с команды where py — она покажет, на каком этапе система теряет файл.
Частые вопросы
Чем команда py отличается от python?
py — это лаунчер для Windows, который умеет выбирать версию интерпретатора (например, py -3.10), а python запускает конкретный интерпретатор напрямую. Для обычного запуска скриптов обе команды взаимозаменяемы.
Можно ли обойтись без py launcher?
Да. Если команда python работает, лаунчер не обязателен — просто замените py на python в командах запуска. Лаунчер удобен только при наличии нескольких версий Python.
Почему после правки PATH ошибка не исчезла?
Открытые окна командной строки не видят новые значения переменных окружения. Закройте терминал полностью и откройте его снова, затем повторите проверку.
Ошибка появляется только в VS Code, а в cmd всё работает. Что делать?
Перезапустите редактор после изменения PATH, а также проверьте в настройках VS Code, какой интерпретатор выбран для проекта. Встроенный терминал редактора наследует окружение на момент запуска программы.
Нужно ли переустанавливать Windows из-за этой ошибки?
Нет. Ошибка касается только переменных окружения или отсутствующего компонента Python и устраняется настройкой либо повторным запуском установщика — система здесь ни при чём.