MacOS中安装Python(homebrew,pyenv)

前言

由于MacOS中自带Python，而自带的Python关联到许多系统组件，不推荐 禁止使用自带Python

安装homebrew包管理器

homebrew官网
打开终端（terminal）输入以下命令

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 或者
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

若出现443或者超时，请使用全局魔法网络或者export你的7890端口

安装pyenv(Python虚拟环境管理器)

安装pyenv

打开终端（terminal）输入以下命令

brew update
brew install pyenv
brew install openssl readline sqlite3 xz zlib tcl-tk

若出现443或者超时，请使用全局魔法网络或者export你的7890端口，或者自行查询“homebrew国内镜像源”

配置环境

zsh

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init --path)"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
source ~/.zshrc

bash

echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bash_profile
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bash_profile
echo 'eval "$(pyenv init --path)"' >> ~/.bash_profile
echo 'eval "$(pyenv init -)"' >> ~/.bash_profile
source ~/.bash_profile

通过pyenv安装Python

查看可用的 Python 版本列表

pyenv install --list

在显示出来的结果中，选择一个需要安装的版本
截止2025-4-23，Python13.0及以上的版本对于三方库兼容极差，固推荐使用Python12及以下版本

安装特定版本的 Python（例如 3.11.6）

pyenv install 3.11.6

设置全局或本地 Python 版本

设置全局默认的 Python 版本

pyenv global 3.11.6

为当前项目目录设置特定的 Python 版本

pyenv local 3.11.6

验证安装

python --version

若输出你刚才安装的Python版本号，即为安装成功