Исправление ошибки 'python: command not found' за 5 минут

Что означает ошибка CommandNotFoundError

Когда вы запускаете команду python в терминале или командной строке и получаете сообщение python: command not found, операционная система не может найти исполняемый файл Python. Это значит, что либо сама программа не установлена, либо её каталог не добавлен в переменную окружения PATH, через которую ОС ищет команды.

💡 Совет: Сначала проверьте, есть ли Python вообще, а затем убедитесь, что он доступен глобально.

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

1. Python не установлен на системе.
2. Python установлен, но его каталог не добавлен в PATH.
3. Использование неполного имени (python2, python3), когда в системе доступен только один вариант.
4. Повреждение установки (отсутствие исполняемого файла или битая система файлов).

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

Способ 1: Установить Python

Если Python вообще не обнаружен, выполните установку:

• Windows: Скачайтеインストаллятор с сайта python.org и убедитесь, что выбрана опция Add Python to PATH.
• Linux (Ubuntu/Debian): sudo apt install python3 (или python3-pip, если нужны дополнительные модули).
• macOS: brew install python (через Homebrew).

После установки перейдите к следующему шагу — проверке PATH.

Способ 2: Добавить Python в PATH

Если Python установлен, но команда всё равно не работает, нужно добавить его каталог к системным переменным поиска.

Windows

1. Нажмите Кнопка Windows → Настройки → Система → О программе → Дополнительные параметры системы → Переменные среды.
2. В разделе Системные переменные найдите Path и нажмите Изменить.
3. Нажмите Новый и введите полный путь к каталогу с python.exe (например, C:\Python39).
4. Сохраните изменения.

macOS / Linux Откройте ~/.bash_profile (или ~/.zshrc для newer shells) и добавьте:

export PATH="$PATH:/usr/local/bin"

Затем примените изменения: source ~/.bash_profile.

⚠️ Важно: После изменения PATH перезапустите терминал или командную строку.

Способ 3: Использовать полное имя

Если в системе доступен только python3, укажите его явно:

python3 --version
# или сделайте символьную ссылку
sudo ln -s $(which python3) /usr/local/bin/python

Способ 4: Переустановить Python (если повреждён)

Когда установка выглядит корректной, но команда всё равно отсутствует, попробуйте переустановить Python, предварительно удалив старые остатки:

• Windows: Удалите программу через «Панель управления → Установка и удаление программ».
• Linux: sudo apt purge python3 (или brew uninstall python).
• macOS: brew uninstall python.

Повторите установку, убедившись, что все файлы intact и PATH обновлён.

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

• Всегда разрешайте добавление в PATH во время установки — это предотвращает future проблемы.
• Регулярно проверяйте версию: запускайте python --version после обновления.
• Документируйте путь к Python: сохраните путь к исполняемому файлу (например, /usr/local/bin/python) в заметках, чтобы быстро добавить в PATH, если что-то пойдёт не так.