Ошибка 'python' не распознан: решение для Windows

Что означает ошибка 'python' не является внутренней или внешней командой

Ошибка 'python' не является внутренней или внешней командой, исполняемой программой или пакетным файлом появляется в командной строке Windows (CMD или PowerShell) при попытке запустить команду python. Система не может найти исполняемый файл python.exe ни в текущей папке, ни в папках, указанных в переменной среде PATH. В результате команда python недоступна глобально.

Обычно ошибка возникает сразу после установки Python или при использовании нового терминала без перезагрузки системы.

Причины возникновения

1. Python не установлен — программа отсутствует в системе.
2. Python установлен, но не добавлен в PATH — во время установки не была отмечена опция «Add Python to PATH».
3. Путь к Python в PATH указан неверно — например, после обновления Python путь изменился, но старая запись осталась.
4. Изменения в PATH не вступили в силу — после добавления пути не перезапускалась командная строка или компьютер.
5. Установка Python для одного пользователя — путь добавлен только в переменные среды пользователя, а вы работаете от другого аккаунта.

Способы решения

Способ 1: Добавление Python в переменную PATH вручную

Это основной и самый надежный способ. Вы вручную укажете системе, где искать python.exe.

1. Найдите папку установки Python
   Откройте Проводник и перейдите в:
   C:\Users\<Ваше_имя_пользователя>\AppData\Local\Programs\Python\
   Здесь вы увидите одну или несколько папок с версиями Python (например, Python39, Python310). Запомните путь к нужной версии. Также понадобится подпапка Scripts внутри этой папки.
2. Откройте редактор переменных среды
   Нажмите Win + R, введите sysdm.cpl и нажмите Enter.
   Перейдите на вкладку «Дополнительно» → кнопка «Переменные среды».
3. Добавьте пути в переменную Path
   В разделе «Системные переменные» (или «Переменные среды пользователя», если Python установлен только для вас) найдите переменную Path и выберите «Изменить».
   Нажмите «Создать» и добавьте два пути:
   • Путь к папке Python (например, C:\Users\Иван\AppData\Local\Programs\Python\Python39)
   • Путь к папке Scripts (например, C:\Users\Иван\AppData\Local\Programs\Python\Python39\Scripts)
4. Примените изменения
   Нажмите «ОК» во всех окнах.
5. Перезапустите командную строку
   Закройте все открытые окна CMD/PowerShell и откройте заново.
6. Проверьте работу команды
   Введите:

   python --version
   

   
   Если видите версию Python (например, Python 3.9.7), ошибка устранена.

⚠️ Важно: Если у вас несколько версий Python, добавьте в PATH только одну (ту, которую хотите использовать по умолчанию), иначе система может запускать не ту версию.

Способ 2: Переустановка Python с автоматическим добавлением в PATH

Если вы не хотите настраивать PATH вручную, переустановите Python, обязательно отметив соответствующую галочку.

1. Скачайте установщик Python с официального сайта.
2. Запустите установщик.
3. Внизу окна установки отметьте галочку «Add Python to PATH» — это критически важно.
4. Выберите «Customize installation» (если нужно настроить компоненты) или «Install now» для стандартной установки.
5. Дождитесь завершения.
6. Перезапустите командную строку и проверьте python --version.

Способ 3: Запуск Python по полному пути (временное решение)

Если нужно срочно запустить скрипт, а настройка PATH недоступна, используйте полный путь к исполняемому файлу.

Например:

"C:\Users\Иван\AppData\Local\Programs\Python\Python39\python.exe" скрипт.py

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

Профилактика

• При установке Python всегда отмечайте «Add Python to PATH» — это предотвратит проблему.
• При обновлении Python до новой версии проверьте PATH — старый путь может указывать на удалённую версию. Удалите неактуальные записи из переменной Path.
• Избегайте перемещения папки Python после установки — если переместите, PATH станет невалидным. Лучше переустановите Python в нужное место.
• Регулярно проверяйте PATH на наличие несуществующих путей через echo %PATH% (CMD) или $Env:Path (PowerShell).