Как настроить переменную PATH для Python на macOS: подробное руководство

Введение / Зачем это нужно

Если при попытке запустить Python в терминале macOS вы видите сообщение command not found, скорее всего, путь к интерпретатору не добавлен в переменную окружения PATH. В этом руководстве вы узнаете, как правильно настроить PATH для Python на macOS, чтобы команды python и python3 работали из любого места в терминале.

Требования / Подготовка

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

• У вас установлен Python 3.x (проверить можно командой python3 --version).
• Вы знакомы с базовыми командами терминала.
• У вас есть доступ к домашней директории для редактирования конфигурационных файлов.

Пошаговая инструкция

Шаг 1: Проверьте текущий PATH и расположение Python

Откройте Терминал и выполните:

echo $PATH

Эта команда выведет текущий список путей, разделённых двоеточиями. Затем проверьте, где расположен исполняемый файл Python:

which python3

Если команда which ничего не выводит, Python либо не установлен, либо его путь не добавлен в PATH. В таком случае сначала установите Python (например, через Homebrew или с официального сайта).

Шаг 2: Определите оболочку и конфигурационный файл

macOS использует разные оболочки командной строки: bash (до версии Catalina) или zsh (с Catalina и новее). Определите текущую оболочку:

echo $SHELL

Вывод будет something like /bin/zsh или /bin/bash. Соответствующие конфигурационные файлы:

• Для zsh: ~/.zshrc
• Для bash: ~/.bash_profile или ~/.bashrc

Откройте нужный файл в текстовом редакторе. Например, для zsh:

nano ~/.zshrc

Или используйте vim или любой другой редактор по вашему выбору.

Шаг 3: Добавьте путь к Python в переменную PATH

В открытом файле найдите конец файла и добавьте строку, которая добавит директорию с исполняемым файлом Python в начало PATH. Предположим, which python3 вернул /usr/local/bin/python3. Тогда директория — /usr/local/bin. Добавьте:

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

💡 Совет: Указывайте путь именно к директории, а не к самому файлу python3. И используйте двойные кавычки, если путь содержит пробелы (обычно нет).

Сохраните файл и закройте редактор. В nano это Ctrl+O (Enter для подтверждения) и Ctrl+X.

Шаг 4: Примените изменения и проверьте результат

Чтобы изменения вступили в силу без перезапуска терминала, выполните:

source ~/.zshrc   # для zsh
# или
source ~/.bash_profile   # для bash

Если вы не уверены, какой файл редактировали, просто перезакройте и откройте Терминал заново. Затем проверьте, что Python теперь в PATH:

which python3

Эта команда должна вывести путь, который вы добавили (например, /usr/local/bin/python3). Также проверьте версию:

python3 --version

Если команды работают, настройка завершена.

Проверка результата

Убедитесь, что python3 доступен из любого каталога. Попробуйте перейти в другую директорию, например:

cd ~
python3 --version

Если вы видите версию Python, значит, PATH настроен корректно. Также можно попробовать запустить Python интерактивно: python3 и выйти с exit().

Возможные проблемы

Python не найден после настройки

• Убедитесь, что вы добавили правильный путь к директории (а не к файлу). Проверьте, что which python3 возвращает путь, который вы указали в export.
• Убедитесь, что вы редактировали конфигурационный файл для вашей текущей оболочки.
• После редактирования файла обязательно выполните source или перезапустите терминал.

Не та версия Python запускается

Порядок путей в PATH важен: система ищет исполняемые файлы слева направо. Если у вас несколько версий Python, убедитесь, что путь к нужной версии стоит раньше других. Можно проверить порядок: echo $PATH.

Ошибка при выполнении source

Возможно, в конфигурационном файле есть синтаксическая ошибка. Откройте файл и проверьте, что строка export PATH="..." написана верно, без лишних символов.

Изменения не сохраняются после перезапуска

Убедитесь, что вы редактировали правильный файл (например, ~/.zshrc для zsh). Если вы используете другую оболочку, изменения не применятся.