Когда вы видите'python' is not recognized as an internal or external commandэту ошибку, это означает, что Windows не может найти исполняемый файл Python в переменной среды PATH.

Добавив правильный каталог в PATH, вы сможете запускать Python и pip в любом терминале без полных путей.

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

Подробные указания о PATH, параметрах установщика и Python Launcher см. в главе «Использование Python в Windows» официальной документации Python (docs.python.org).

Способ 1: используйте официальный установщик для добавления PATH (рекомендуется)

Установщик с python.org может настроить PATH за вас напрямую, избегая ошибок при ручном вводе, а также добавляет папку Scripts, необходимую для pip.

Тот же установщик также можно использовать с параметромModify, чтобы добавить PATH к существующей установке без переустановки.

Шаги

Экран установки — обязательно отметьте опцию PATH:

Если уже установлено, выберите опцию Modify:

Проверьте, успешно ли прошла установка:

python --version
pip --version
where python
where pip

Если вы уже установили Python, но не отметили опцию PATH в тот момент, просто запустите установщик снова, выберитеModify, затем отметьте "Add python.exe to PATH" и снова откройте терминал после завершения установки.

Способ 2: Добавить Python в PATH вручную (на уровне пользователя)

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

Шаги

Шаг 1 — Откройте свойства системы через sysdm.cpl:

Шаг 2 — Окно переменных среды:

Шаг 3 — Отредактируйте переменную Path:

Шаг 4 — Создайте новую запись пути установки Python:

Шаг 5 — Добавьте каталог Scripts:

Шаг 6 — Переместите записи вверх, чтобы они обнаруживались первыми:

Шаг 7 — Подтвердите и сохраните все диалоговые окна:

Шаг 9 — Проверьте результат:

python --version
pip --version
where python
where pip

Примечания и распространённые ошибки

Способ 3: Исправление "псевдонимов выполнения приложений" для установок из Microsoft Store

Если вы установили Python из Microsoft Store, он полагается на "псевдонимы выполнения приложений" и каталог WindowsApps для распознавания команды python, а не на традиционное редактирование PATH.

Шаги

Пункт настроек псевдонима выполнения приложений:

Переключатели псевдонимов python.exe и python3.exe:

Если при вводеpythonоткрывается Microsoft Store вместо запуска Python, значит псевдоним указывает на Store. Отключите псевдоним для соответствующей версии, установите вместо этого версию с python.org или используйте Python Launcher (команду py), описанный ниже.

Способ 4: Использование Python Launcher вместо редактирования PATH

Python Launcher（py.exe) устанавливается вместе со сборками python.org и может автоматически находить установленные версии Python по меткам, полностью избегая конфликтов PATH.

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

Шаги

Проверка версии Launcher:

py --version

Явно запустить нужную версию Python:

py -3
py -3.11
py -3.10 -m pip --version

Использовать Launcher для создания и использования виртуальных сред:

# 使用指定版本创建虚拟环境
py -3.11 -m venv venv

# 激活虚拟环境
venv\Scripts\activate

# 在虚拟环境中确认 Python 版本
python --version

Дополнительные примечания

При использовании py Launcher можно полностью пропустить ручное редактирование PATH. Launcher автоматически обнаруживает все установленные версии Python и позволяет выбирать нужную по мере необходимости — это особенно удобно для разработчиков, которым нужны одновременно Python 3.10 и 3.12.

Быстрая проверка и устранение неполадок

Убедиться, какой исполняемый файл запущен

where python
where python3
where py

Проверить pip и Scripts

pip --version
where pip

Распространённые проблемы

Итог

Когда PATH настроен правильно — или вы начинаете использовать Python Launcher — вы можете запускать Python и pip откуда угодно, не вводя полный путь.

Для сред с несколькими версиями настоятельно рекомендуется использовать Python Launcher для точного выбора версий в сочетании с виртуальными средами для поддержания изоляции зависимостей каждого проекта.