Mac 系统 Python 开发环境搭建：Pyenv + Virtualenv

验证安装

# 查看 pyenv 版本
pyenv --version

安装 pyenv-virtualenv 插件

克隆插件到 pyenv 插件目录

# 克隆插件到 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"

实战

Pyenv 基本使用命令

# 查看可安装的 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-Virtualenv 基本使用命令

# 查看所有虚拟环境
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

虚拟环境中安装 Python 包

pip install 切换镜像源

1. 快速解决（临时换源）

# 清华源（推荐）
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

2. 永久配置（命令行配置）

# 清华源
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