Установка Python на macOS: подробное руководство 2026

Введение

Python — один из самых популярных языков программирования, который используется для веб-разработки, анализа данных, автоматизации и многого другого. Установка Python на macOS проста, но важно выбрать подходящий способ, чтобы избежать проблем с путями и версиями.

В этом руководстве мы рассмотрим три основных способа установки Python 3 на Mac:

1. Через официальный установщик с сайта python.org (самый простой вариант).
2. Через Homebrew — менеджер пакетов для macOS (удобно для разработчиков).
3. Через pyenv — менеджер версий Python (для тех, кому нужно часто переключать версии).

Мы также покажем, как проверить, что Python установлен правильно, и как настроить переменную окружения PATH, если команды не работают.

Перед началом: проверьте, есть ли уже Python

macOS традиционно поставляется с Python 2.7 (в macOS до 12 Monterey) или с Python 3 (в более новых версиях, начиная с macOS 12.3). Однако системный Python часто устарел и не предназначен для разработки.

Откройте Терминал (через Spotlight или Finder → Программы → Утилиты) и выполните:

python3 --version

Если вы видите что-то вроде Python 3.11.5, значит Python 3 уже установлен. Если команда не найдена, или версия слишком старая (например, 3.8), вам нужно установить новую версию.

💡 Совет: Всегда используйте команду python3 вместо python, чтобы явно указать на Python 3. Системный python (если есть) — это Python 2.7.

Способ 1: Установка через официальный установщик

Этот способ идеален для новичков. Установщик с python.org автоматически настраивает PATH и добавляет pip (менеджер пакетов Python).

Шаг 1: Скачайте установщик

1. Перейдите на официальный сайт: python.org/downloads/macos/
2. Выберите последнюю стабильную версию (например, Python 3.12.x). Скачайте 64-bit installer (файл .pkg).

Шаг 2: Запустите установщик

1. Откройте скачанный файл .pkg (например, python-3.12.1-macos11.pkg).
2. Следуйте инструкциям мастера установки. Оставьте все настройки по умолчанию.
3. Установщик автоматически:
   • Установит Python в /Library/Frameworks/Python.framework/Versions/3.x
   • Добавит символические ссылки в /usr/local/bin/ (это стандартное место для пользовательских программ на macOS).
   • Установит pip (менеджер пакетов).

Шаг 3: Проверьте установку

После завершения установки откройте новое окно Терминала (важно, чтобы обновились переменные окружения) и выполните:

python3 --version
pip3 --version

Вы должны увидеть установленные версии. Если команды не работают, возможно, потребуется перезагрузить Терминал или даже Mac.

⚠️ Важно: Установщик python.org не перезаписывает системный Python 2.7. Он устанавливает Python 3 в отдельную директорию, что безопасно.

Способ 2: Установка через Homebrew

Homebrew — это менеджер пакетов для macOS, который упрощает установку и обновление программ из командной строки. Если вы уже используете Homebrew для других инструментов ( Git, Node.js и т.д.), этот способ будет самым удобным.

Шаг 1: Установите Homebrew (если ещё нет)

Если Homebrew не установлен, выполните в Терминале:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Следуйте инструкциям на экране. После установки добавьте Homebrew в PATH, как предложит установщик (обычно это команда echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile для Apple Silicon или eval "$(/usr/local/bin/brew shellenv)" для Intel).

Проверьте установку:

brew --version

Шаг 2: Установите Python

Теперь установите Python:

brew update
brew install python

Homebrew установит последнюю версию Python 3 и pip. Все файлы будут размещены в /opt/homebrew/Cellar/python/ (для Apple Silicon) или /usr/local/Cellar/python/ (для Intel), а символические ссылки создадутся в /opt/homebrew/bin/ или /usr/local/bin/.

Шаг 3: Проверьте установку

python3 --version
pip3 --version

Homebrew также предоставляет команду brew upgrade python для обновления Python в будущем.

💡 Совет: Homebrew управляет зависимостями, поэтому если вы устанавливаете Python для разработки, этот способ предпочтительнее — он легче обновляется и интегрируется с другими инструментами.

Способ 3: Установка через pyenv (для продвинутых)

pyenv — это менеджер версий Python, который позволяет устанавливать и легко переключаться между несколькими версиями Python (например, 3.9 для одного проекта и 3.12 для другого). Этот способ подходит, если вы работаете с разными проектами, требующими специфичных версий Python.

Шаг 1: Установите pyenv через Homebrew

brew install pyenv

Шаг 2: Настройте оболочку

pyenv требует настройки оболочки (bash, zsh, fish). Для zsh (по умолчанию в macOS с 10.15) добавьте в файл ~/.zshrc:

echo 'eval "$(pyenv init --path)"' >> ~/.zprofile
echo 'eval "$(pyenv init -)"' >> ~/.zshrc

Для bash добавьте в ~/.bash_profile:

echo 'eval "$(pyenv init --path)"' >> ~/.bash_profile
echo 'eval "$(pyenv init -)"' >> ~/.bashrc

Перезагрузите Терминал или выполните source ~/.zshrc (или source ~/.bash_profile).

Шаг 3: Установите нужную версию Python

# Посмотреть доступные версии
pyenv install --list

# Установить конкретную версию (например, 3.12.1)
pyenv install 3.12.1

# Установить последнюю стабильную версию
pyenv install 3.12

Шаг 4: Установите глобальную версию (опционально)

Чтобы использовать установленную версию по умолчанию:

pyenv global 3.12.1

Теперь команды python и python3 будут ссылаться на эту версию.

⚠️ Важно: pyenv управляет версиями Python в ~/.pyenv/versions/. Он не конфликтует с системным Python или установками через Homebrew.

Настройка переменной PATH (если Python не распознаётся)

Если после установки команда python3 или pip3 не работает, возможно, путь к Python не добавлен в переменную окружения PATH.

Где находится Python?

• Официальный установщик: /Library/Frameworks/Python.framework/Versions/3.x/bin/
• Homebrew: /opt/homebrew/bin/ (Apple Silicon) или /usr/local/bin/ (Intel)
• pyenv: ~/.pyenv/shims/ (добавляется автоматически при настройке)

Как добавить путь в PATH?

1. Определите, какая оболочка используется. В Терминале выполните:

echo $SHELL

Если вывод /bin/zsh — это zsh, если /bin/bash — bash.

2. Откройте конфигурационный файл оболочки:
   • Для zsh: nano ~/.zshrc (или любой другой редактор)
   • Для bash: nano ~/.bash_profile
3. Добавьте строку (подставьте правильный путь):

# Для официального установщика
export PATH="/Library/Frameworks/Python.framework/Versions/3.12/bin:$PATH"

# Для Homebrew (Apple Silicon)
export PATH="/opt/homebrew/bin:$PATH"

# Для Homebrew (Intel)
export PATH="/usr/local/bin:$PATH"

4. Сохраните файл (в nano: Ctrl+X, затем Y, затем Enter) и перезагрузите оболочку:

source ~/.zshrc  # или source ~/.bash_profile

5. Проверьте:

which python3
echo $PATH

Проверка установки и первый скрипт

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

# Проверка версии Python
python3 --version

# Проверка pip (менеджер пакетов)
pip3 --version

# Создайте тестовый скрипт
echo 'print("Hello, Python!")' > hello.py

# Запустите его
python3 hello.py

Если вы видите Hello, Python! — Python установлен и работает.

Частые проблемы и их решение

Проблема 1: command not found: python3

Причина: Путь к Python не добавлен в PATH.

Решение: Следуйте инструкциям в разделе Настройка переменной PATH.

Проблема 2: Конфликт версий после установки через Homebrew и официальный установщик

Причина: Оба способа добавляют свои пути в PATH, и порядок может привести к использованию не той версии.

Решение:

• Проверьте порядок путей: echo $PATH.
• Убедитесь, что путь к нужной версии Python идёт раньше.
• При необходимости отредактируйте ~/.zshrc или ~/.bash_profile, чтобы расставить приоритеты.

Проблема 3: pip3 не устанавливает пакеты глобально (ошибка доступа)

Причина: Попытка записи в системные директории без прав администратора.

Решение:

• Используйте флаг --user для установки в домашнюю директорию:

pip3 install --user package_name

• Или настройте виртуальные окружения (см. Что дальше?).

Проблема 4: После установки через pyenv команда python всё равно ссылается на старую версию

Причина: pyenv не инициализирован в текущей оболочке.

Решение:

• Убедитесь, что вы добавили инициализацию pyenv в конфигурационный файл оболочки (см. Шаг 2).
• Перезапустите Терминал или выполните exec $SHELL.

Что дальше?

Теперь, когда Python установлен, вы можете:

1. Настроить виртуальные окружения — изолировать зависимости для каждого проекта. Используйте встроенный модуль venv:

# Создание виртуального окружения
python3 -m venv myenv

# Активация (для zsh/bash)
source myenv/bin/activate

# Установка пакетов внутри окружения
pip install requests

2. Установить IDE или редактор кода:
   • Visual Studio Code с расширением Python.
   • PyCharm (Community Edition бесплатна).
   • Sublime Text или Atom.
3. Обновлять pip:

pip3 install --upgrade pip

4. Установить популярные пакеты для начала:

pip3 install numpy pandas matplotlib jupyter

5. Написать и запустить первый проект — например, веб-приложение на Flask или Django.

Заключение

Установка Python на macOS — это простой процесс, который займёт у вас не более 10 минут. Вы можете выбрать официальный установщик для максимальной простоты, Homebrew для удобного управления или pyenv для работы с несколькими версиями.

После установки не забудьте проверить версии python3 и pip3, а также настроить PATH, если команды не распознаются. Если возникнут проблемы — вернитесь к разделу Частые проблемы.

Удачной разработки! 🐍