«python» не является внутренней или внешней командой

Сообщение значит, что Windows не нашла программу python ни в одной папке из списка PATH. Почти всегда причина одна из трёх: Python не установлен, установлен без галочки PATH или терминал открыт раньше, чем закончилась установка. В Linux и macOS команда называется иначе — сразу переходите к разделу Linux и macOS.

В командной строке ошибка выглядит так:

'python' не является внутренней или внешней командой, исполняемой программой или пакетным файлом.

В PowerShell — «Имя "python" не распознано как имя командлета, функции, файла сценария или выполняемой программы». Смысл тот же.

Что сделать по порядку

Пробуйте по очереди, пока команда не заработает.

1. 1Открыть терминал заново

   Окна, открытые до установки, не видят изменений PATH. Закройте терминал и откройте новый. Если работаете в VS Code — перезапустите его целиком. Проверьте в новом окне:

   python --version

   Появилась строка вида Python 3.12.3 — команда работает.

   Не помогло — дальше: «Попробовать команду py»

2. 2Попробовать команду py

   Наберите py --version.

   Версия появилась — Python установлен, просто команда python не в PATH. Можно пользоваться py вместо python: py hello.py, py -m pip install requests. Чтобы заработала и python, сделайте шаг 3.

   Не помогло — дальше: «Добавить Python в PATH»

3. 3Добавить Python в PATH

   Запустите установщик Python ещё раз, выберите Modify и отметьте добавление в переменные среды — или переустановите Python с галочкой Add python.exe to PATH. По шагам — в справке Как установить Python на Windows. Затем откройте новый терминал и наберите python --version.

   В новом окне python --version показывает версию — готово.

   Не помогло — дальше: «Установить Python»

4. 4Установить Python

   Если не находятся ни python, ни py, а в списке программ («Параметры» → «Приложения») Python нет, он не установлен. Установите его по справке Как установить Python на Windows.

Вместо Python открывается Microsoft Store

В Windows 10 и 11 есть заглушки с именами python.exe и python3.exe: если настоящего Python нет, они открывают Microsoft Store или выводят сообщение вроде «Python was not found; run without arguments to install from the Microsoft Store…». Это не ошибка: так Windows подсказывает, что Python не установлен.

• Если Python поставлен обычным установщиком с python.org, а команда всё равно открывает магазин, — откройте «Пуск», найдите по слову «псевдонимы» настройку псевдонимов выполнения приложений и выключите там пункты python.exe и python3.exe с подписью «Установщик приложения».
• Если Python поставлен через Python install manager, у него в той же настройке свои псевдонимы — пункты с названием Python, например «Python (default)». Они должны быть включены; если включены, а команда не работает, выключите их и включите снова.

Какой Python запускается

Команда показывает все найденные python.exe в порядке поиска — запускается первый:

where python

В PowerShell слово where значит другое, там пишите where.exe python. Если Python ставился обычным установщиком, а первой в списке стоит папка WindowsApps, — это заглушка магазина. У менеджера установки команды лежат в той же папке WindowsApps, для него это нормально.

Linux и macOS

В Linux и macOS команда называется python3, а python может отсутствовать — ошибка python: command not found. Пишите python3:

python3 --version
python3 hello.py

В Ubuntu и Debian, чтобы работала и команда python, можно поставить пакет, который делает её синонимом python3:

sudo apt install python-is-python3

Ошибка внутри Python

Если вы набрали python или pip install в окне, где уже стоит приглашение >>>, получится NameError или SyntaxError: это окно самого Python, а не терминал. Выйдите из него командой exit() и наберите команду снова.