本文介绍了在 Mac 系统下使用 Pyenv 和 Virtualenv 搭建 Python 开发环境的完整方案。内容包括 Pyenv 和 Virtualenv 的核心功能介绍、通过 Git 安装及配置环境变量、国内镜像加速设置。实战部分涵盖了版本管理命令、虚拟环境创建与激活流程、以及 pip 包管理器的镜像源切换方法。该方案实现了多 Python 版本共存与项目依赖隔离，避免破坏系统环境，适合开发者进行高效的项目开发与部署。
Pyenv 是一个用于管理多个 Python 版本的开源工具，允许你在同一台机器上轻松安装、切换和管理不同的 Python 版本，而不会产生冲突。最初由 Yoshinori Kawasaki 开发，现由 Python 社区维护，是 Mac 和 Linux 系统上最受欢迎的 Python 版本管理器之一。
核心功能
Virtualenv 是一个用于创建隔离 Python 环境的工具，它能为每个项目生成独立的虚拟环境，使不同项目的依赖包互不干扰。每个虚拟环境都是一个包含独立 Python 解释器、库和脚本的目录。由 Ian Bicking 创建，是 Python 生态中最经典、最轻量的虚拟环境管理工具，至今仍是许多开发者的首选方案。
核心功能
# 克隆 pyenv 仓库到本地电脑指定目录
git clone https://github.com/pyenv/pyenv.git /Users/woniu/GitHub/pyenv
# 配置环境变量（zsh 示例）
echo 'export PYENV_ROOT="/Users/woniu/GitHub/pyenv"' >> ~/.zshrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'export PATH="$PYENV_ROOT/shims:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
# 使配置生效
source ~/.zshrc
# 查看 pyenv 版本
pyenv --version
# 克隆插件到 pyenv 插件目录
git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
命令解析
$(pyenv root) 自动获取 pyenv 安装目录。pyenv/plugins/ 子目录下才能被识别。# 配置环境变量（zsh 示例）
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.zshrc
# 使配置生效
source ~/.zshrc
# 检查插件是否被识别
pyenv help | grep virtualenv
# 查看可用的 virtualenv 命令
pyenv virtualenv --help
# 查看 virtualenv 插件版本
pyenv virtualenv --version
pyenv install 速度过慢，使用国内镜像加速。
# 在 ~/.zshrc 或 ~/.bash_profile 中添加
# 加速 GNU 包（解决 readline 下载慢）
echo 'export PYTHON_BUILD_MIRROR_URL="https://mirrors.huaweicloud.com/gnu/"' >> ~/.zshrc
# 加速 Python 源码
echo 'export PYTHON_BUILD_PACKAGE_MIRROR_URL="https://mirrors.huaweicloud.com/python/"' >> ~/.zshrc
# 跳过校验（解决镜像不一致问题）
echo 'export PYTHON_BUILD_MIRROR_URL_SKIP_CHECKSUM=1' >> ~/.zshrc
# 使配置生效
source ~/.zshrc
# 验证两个变量
echo "GNU 镜像：$PYTHON_BUILD_MIRROR_URL"
echo "Python 镜像：$PYTHON_BUILD_PACKAGE_MIRROR_URL"
# 查看可安装的 Python 版本
pyenv install --list | grep "^ 3."
# 安装指定版本
pyenv install 3.11.8
pyenv install 2.7.18
# 查看已安装 python 版本
pyenv versions
# 设置全局默认版本
pyenv global 3.11.8
# 设置当前项目版本（创建 .python-version 文件）
cd ~/myproject
pyenv local 2.7.18
# 查看 pyenv 当前版本
pyenv version
# 查看 python 当前版本
python --version
# 查看所有虚拟环境
pyenv virtualenvs
# 创建虚拟环境（基于指定 Python 版本）
pyenv virtualenv 3.11.8 myproject-env
# 删除虚拟环境
pyenv uninstall myproject-env
# 或
pyenv virtualenv-delete myproject-env
# 激活虚拟环境（自动切换 Python 版本）
pyenv activate myproject-env
# 退出虚拟环境
pyenv deactivate
# 为项目目录设置本地虚拟环境（推荐）
pyenv local myproject-env
# 这会创建 .python-version 文件，进入目录时自动激活
# 设置全局默认虚拟环境
pyenv global myproject-env
# 查看虚拟环境所在路径
pyenv prefix myproject-env
# 1. 安装所需 Python 版本
pyenv install 3.11.6
# 2. 创建项目虚拟环境
pyenv virtualenv 3.11.6 myproject-env
# 3. 进入项目目录并激活
cd myproject
pyenv local myproject-env
# 验证：查看 Python 路径
which python
# 输出应为：~/.pyenv/versions/myproject-env/bin/python
# 清华源（推荐）
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests
# 阿里源
pip install -i https://mirrors.aliyun.com/pypi/simple/ pandas
# 中科大源
pip install -i https://pypi.mirrors.ustc.edu.cn/simple/ numpy
# 豆瓣源
pip install -i https://pypi.douban.com/simple/ django
# 清华源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
# 验证配置
pip config list
激活后，直接使用 pip 安装，无需 sudo：
# 安装单个包
pip install requests pandas numpy
# 从 requirements.txt 批量安装
pip install -r requirements.txt
# 指定版本安装
pip install django==4.2.7
# 卸载包
pip uninstall -y django==4.2.7
# 查看已安装的包
pip list
# 查看某个包的详细信息
pip show requests
# 以 requirements.txt 格式输出（适合导出）
pip freeze > requirements.txt
# 检查是否有可更新的包
pip list --outdated
# 统计包的数量
pip list | wc -l
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online