В macOS по умолчанию установлена устаревшая версия Python 2.7, поддержка которой прекращена. Даже при наличии установленного Python 3, система может по-прежнему использовать старую версию, если не указано иное. Для работы с актуальными библиотеками и инструментами разработки требуется обновить Python вручную через терминал.
Проверить текущую версию Python можно командой python3 —version. Если вы видите версию ниже актуальной (уточнить можно на https://www.python.org), потребуется установить новую через Homebrew – это предпочтительный способ управления пакетами в macOS. Убедитесь, что Homebrew установлен, выполнив команду brew —version. Если не установлен – выполните /bin/bash -c «$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)».
Для установки последней версии Python выполните brew install python. Homebrew добавит исполняемый файл Python 3 (обычно как /opt/homebrew/bin/python3 на Apple Silicon или /usr/local/bin/python3 на Intel Mac). Чтобы новая версия Python использовалась по умолчанию, настройте PATH в файле .zshrc или .bash_profile, добавив строку export PATH=»/opt/homebrew/bin:$PATH» или соответствующую вашей архитектуре.
Проверьте, что обновление прошло успешно, командой which python3 – путь должен указывать на директорию Homebrew. Затем выполните python3 —version и убедитесь, что отображается актуальная версия. Дополнительно рекомендуется установить pip и venv для управления пакетами и виртуальными окружениями: python3 -m ensurepip —upgrade и python3 -m venv env.
Проверка текущей версии Python в терминале macOS
Откройте Terminal через Spotlight (Cmd + Пробел → введите “Terminal”). Для получения версии предустановленного Python 2.x выполните:
python --version
Результат может выглядеть так:
Python 2.7.18
Для Python 3 используйте:
python3 --version
Python 3.11.6
Для уточнения, какой бинарный файл запускается при вызове команды, выполните:
which python
– покажет путь к бинарнику Python 2which python3
– путь к установленному Python 3
Для пользователей, использующих Homebrew, проверить установленную версию можно так:
brew list python
Если Python установлен через pyenv, получите активную версию с помощью:
pyenv version
Чтобы убедиться, что Python корректно установлен и используется нужная версия, выполните:
python3 -c "import sys; print(sys.executable, sys.version)"
Выбор версии Python для обновления
Перед установкой новой версии Python на Mac важно определить, какая именно версия необходима. Это зависит от целей: поддержки существующих проектов, совместимости с библиотеками или получения новых возможностей языка.
- Если требуется стабильность и широкая поддержка библиотек – используйте последнюю стабильную версию из серии 3.x, рекомендованную на python.org.
- Для разработки с использованием новейших возможностей языка выбирайте последнюю релизную версию. На момент мая 2025 года актуальна версия Python 3.12.3.
- Если проект требует конкретной версии (например, 3.10.13), проверьте совместимость всех зависимостей перед обновлением.
Проверить доступные версии можно через менеджер версий pyenv:
pyenv install --list
Из списка выбирается нужная версия, затем устанавливается командой:
pyenv install 3.12.3
Чтобы использовать её по умолчанию:
pyenv global 3.12.3
Не устанавливайте версии Python 2.x, если только не поддерживаете устаревший код. Поддержка Python 2 окончательно завершена в январе 2020 года.
Удаление старой версии Python, установленной вручную
Если предыдущая версия Python была установлена вручную через сборку из исходников или загрузку установщика с python.org, её удаление не затронет системный Python, встроенный в macOS.
Для начала определите путь к установленному Python с помощью команды:
which -a python3
Если путь указывает на директорию вроде /usr/local/bin/python3
, проверьте, к какому бинарнику он ведёт:
ls -l /usr/local/bin/python3
Обычно это символьная ссылка на файл в /usr/local/Cellar
(при установке через Homebrew) или /Library/Frameworks/Python.framework
(при ручной установке).
Для удаления версии, установленной через официальный установщик, выполните:
sudo rm -rf /Library/Frameworks/Python.framework
Удалите также симлинки из /usr/local/bin
:
cd /usr/local/bin
ls -l | grep '../Library/Frameworks/Python.framework' | awk '{print $9}' | xargs sudo rm
Если версия была собрана вручную и установлена через make install
, удалите соответствующие бинарники и директории в /usr/local/bin
, /usr/local/lib
, /usr/local/include
и /usr/local/share/man
. Ищите по имени установленной версии, например:
sudo rm /usr/local/bin/python3.10
sudo rm -rf /usr/local/lib/python3.10
sudo rm -rf /usr/local/include/python3.10
После удаления проверьте, что старая версия больше не доступна:
python3 --version
Если команда не распознаётся или указывает на системную версию, удаление выполнено корректно.
Установка Homebrew для управления пакетами
Откройте терминал и выполните команду:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
После установки добавьте Homebrew в переменную окружения, если это не сделано автоматически. Для пользователей zsh:
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
Проверьте успешность установки:
brew --version
brew update
Теперь вы можете устанавливать, обновлять и удалять пакеты, включая версии Python, через Homebrew.
Установка новой версии Python с помощью Homebrew
Для начала убедитесь, что Homebrew установлен. Введите в терминале brew --version
. Если утилита отсутствует, установите её командой:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Обновите информацию о пакетах:
brew update
Затем выполните установку Python:
brew install python
После завершения проверьте установленную версию:
python3 --version
Homebrew устанавливает Python3 по пути /opt/homebrew/bin/python3
(на ARM-чипах) или /usr/local/bin/python3
(на Intel). Чтобы использовать его по умолчанию, настройте приоритет в ~/.zprofile
или ~/.bash_profile
:
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zprofile
Примените изменения:
source ~/.zprofile
Для управления несколькими версиями Python рекомендуется установить pyenv
:
brew install pyenv
Проверьте, не конфликтует ли установленный Python с системной версией. Не удаляйте системный Python – он используется macOS.
Настройка переменных окружения и пути PATH
Для корректной работы обновленного Python на Mac необходимо правильно настроить переменные окружения, в частности, путь PATH. Это позволит системе находить и использовать версию Python, установленную через терминал.
Переменная окружения PATH отвечает за список директорий, в которых система ищет исполняемые файлы. Чтобы добавить в PATH новую версию Python, нужно отредактировать файл конфигурации оболочки, например, .bash_profile или .zshrc (для оболочки Zsh, которая используется по умолчанию в macOS с версии 10.15).
Для этого откройте терминал и выполните команду для редактирования файла конфигурации вашей оболочки. Например, для Zsh используйте:
nano ~/.zshrc
Затем добавьте строку, указывающую путь к директории с установленной версией Python. Если вы установили Python через Homebrew, путь будет, как правило, таким:
export PATH="/usr/local/opt/python@3.9/bin:$PATH"
Не забудьте заменить версию Python на ту, которая у вас установлена. После внесения изменений сохраните файл и примените изменения командой:
source ~/.zshrc
Для других оболочек (например, Bash) файл конфигурации будет отличаться. В случае Bash откройте файл .bash_profile с помощью команды:
nano ~/.bash_profile
После внесения изменений в .bash_profile также примените их с помощью:
source ~/.bash_profile
Теперь система будет использовать правильную версию Python при запуске команд в терминале. Чтобы убедиться, что изменения вступили в силу, выполните команду:
python3 --version
Если вы видите нужную версию Python, значит, переменная PATH настроена правильно. Важно помнить, что порядок директорий в PATH имеет значение. Если вы установили несколько версий Python, убедитесь, что путь к новой версии идет первым, чтобы избежать конфликтов с предыдущими установками.
Проверка установленной версии и переключение между версиями
Для начала необходимо узнать текущую версию Python, установленную на вашем Mac. Откройте терминал и выполните команду:
python --version
или python3 --version
В зависимости от конфигурации, одна из этих команд вернёт версию Python, которая используется по умолчанию. Если у вас установлены несколько версий Python, то можно уточнить, какой именно используется, вызвав python3 --version
.
Для переключения между версиями Python, можно воспользоваться менеджером версий, таким как pyenv
. Для установки pyenv
, выполните следующую команду:
brew install pyenv
После установки pyenv
можно проверить доступные версии Python с помощью команды:
pyenv versions
Чтобы установить новую версию Python, используйте команду:
pyenv install
Где
– это номер версии, например, 3.9.1
.
Для переключения на нужную версию, выполните команду:
pyenv global
Эта команда установит выбранную версию Python по умолчанию. Для проверки изменений выполните:
python --version
или python3 --version
Если вы хотите временно использовать другую версию Python в рамках текущей сессии, используйте команду:
pyenv shell
В случае, если вы не хотите использовать pyenv
, можно переключать версию вручную, изменяя символическую ссылку для python
в системе с помощью команды:
sudo ln -sf /usr/local/bin/python3.x /usr/bin/python
Где 3.x
– версия Python, которую вы хотите сделать активной. Однако этот способ не так гибок и может вызвать проблемы при обновлениях системы.
Обновление pip и установка необходимых модулей после обновления
После обновления версии Python важно обновить менеджер пакетов pip. Это обеспечит корректную работу с последними версиями библиотек и улучшенную совместимость с новыми функциями Python. Для этого используйте команду:
python3 -m pip install --upgrade pip
Команда установит последнюю версию pip, которая будет совместима с вашей версией Python. В случае, если у вас несколько версий Python, всегда проверяйте, что обновляете pip для нужной версии, используя соответствующую команду, например:
python3.9 -m pip install --upgrade pip
После обновления pip можно переходить к установке необходимых пакетов. Для этого можно использовать файл с зависимостями, если он есть в вашем проекте (например, requirements.txt
). Команда для установки пакетов:
python3 -m pip install -r requirements.txt
Если файл с зависимостями отсутствует, устанавливайте необходимые модули вручную, используя pip, например:
python3 -m pip install numpy
Если вы используете виртуальные окружения (что рекомендуется), активируйте его перед установкой пакетов:
source venv/bin/activate
После активации виртуального окружения установите нужные пакеты, как указано выше. Важно следить за совместимостью версий пакетов с вашей версией Python, чтобы избежать конфликтов. В случае возникновения ошибок, используйте команду для проверки установленных версий пакетов:
python3 -m pip list
Это позволит убедиться в наличии актуальных версий и при необходимости обновить конкретные библиотеки командой:
python3 -m pip install --upgrade <название_пакета>
После завершения установки всех необходимых пакетов проверьте их работоспособность, запустив тесты или примеры использования. Обновление pip и установка модулей – важный этап поддержания актуальности вашего Python-окружения.