在Mac上搭建Python开发环境需先安装Homebrew和基础依赖，再通过pyenv管理多版本Python，最后用pipenv或poetry实现项目级虚拟环境隔离。

如果您希望在Mac上搭建Python开发环境并灵活切换多个Python版本，则需要安装基础工具链并配置pyenv。以下是完成此任务的具体步骤：

一、安装Homebrew和基础依赖

Homebrew是macOS上最常用的包管理器，用于简化命令行工具的安装；它也是后续安装pyenv的前提。安装过程中会自动配置必要的编译环境。

1、打开终端（Terminal）应用程序。

2、执行以下命令安装Homebrew：
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

立即学习“Python免费学习笔记（深入）”；

3、安装完成后运行 brew doctor 验证安装状态，确保输出中无错误提示。

4、运行 brew install openssl readline sqlite3 xz zlib 来安装pyenv编译Python所需的底层依赖库。

二、安装pyenv

pyenv是一个Python版本管理工具，允许用户在同一台Mac上共存并快速切换多个Python解释器版本，且互不干扰。

1、在终端中执行命令：brew install pyenv

2、安装完成后运行 pyenv --version 检查是否返回类似 2.4.0 的版本号。

3、为使pyenv在每次启动终端时自动生效，需将初始化代码添加至Shell配置文件。根据您使用的Shell类型选择对应操作：
若使用zsh（macOS Catalina及以后默认）：echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc && echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc && echo 'eval "$(pyenv init - zsh)"' >> ~/.zshrc

4、执行 source ~/.zshrc 重新加载配置。

三、通过pyenv安装指定Python版本

pyenv install 命令从源码编译指定版本的Python，并将其安装到 ~/.pyenv/versions/ 目录下，避免与系统Python冲突。

1、运行 pyenv install --list 查看所有可安装的Python版本列表。

2、选择一个常用版本（例如3.11.9），执行：pyenv install 3.11.9

3、等待编译完成，期间终端会输出进度日志；如遇报错，请确认第二步中依赖库已完整安装。

4、安装成功后，运行 pyenv versions 可看到新版本已列出，当前激活版本前有 * 号标记。

四、设置Python版本作用域

pyenv支持全局、当前Shell会话、当前目录三级版本控制，便于区分项目依赖与系统默认行为。

1、设置全局默认版本（影响所有未特别指定的目录）：pyenv global 3.11.9

2、仅对当前终端会话生效：pyenv shell 3.10.13

3、在某项目根目录下执行：pyenv local 3.9.18，会在该目录生成 .python-version 文件，进入该目录时自动切换至指定版本。

4、验证当前生效版本：python --version 应返回所设版本号；注意：必须关闭并重新打开终端或执行 source ~/.zshrc 才能使 global 设置立即生效。

五、安装pipenv或poetry以增强项目隔离能力

仅靠pyenv管理解释器版本尚不足以解决包冲突问题；pipenv和poetry可在指定Python版本下创建独立虚拟环境，实现项目级依赖隔离。

1、确保已用pyenv切换至目标Python版本（如3.11.9），再执行：pip install pipenv

2、进入项目目录，运行 pipenv --python 3.11 创建基于该版本的虚拟环境。

3、运行 pipenv shell 进入隔离环境，此时 python 和 pip 均指向该环境内的解释器与包管理器。

4、替代方案：使用 poetry，先执行 curl -sSL https://install.python-poetry.org | python3 -，再运行 poetry init 初始化项目依赖描述文件。