MacOS中安装Python(homebrew,pyenv)

前言

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

安装homebrew包管理器

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

bash 复制代码

/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）输入以下命令

bash 复制代码

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

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

配置环境

zsh

bash 复制代码

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

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 版本列表

bash 复制代码

pyenv install --list

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

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

bash 复制代码

pyenv install 3.11.6

设置全局或本地 Python 版本

设置全局默认的 Python 版本

bash 复制代码

pyenv global 3.11.6

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

bash 复制代码

pyenv local 3.11.6

验证安装

bash 复制代码

python --version

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