pyenv 是一款强大的 Python 版本管理工具,可帮助开发者在不同项目中灵活切换 Python 版本,避免环境冲突。以下是详细使用指南:
1. 安装 pyenv
# 安装依赖
sudo apt-get update && sudo apt-get install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev xz-utils tk-dev libffi-dev liblzma-dev
# 下载并安装 pyenv
wget https://github.com/pyenv/pyenv/archive/v4.0.1.tar.gz
tar -xzvf v4.0.1.tar.gz
cd pyenv-4.0.1
./configure && make -C src && make -C bin && make install
2. 基础使用
# 查看已安装版本
pyenv versions
# 安装特定版本
pyenv install 3.9.7
# 设置全局版本
pyenv global 3.9.7
# 设置局部版本(针对当前目录)
pyenv local 3.9.7
3. 管理多个版本
- 使用
pyenv versions
列出所有已安装版本 - 通过
pyenv global
设置默认版本 - 在项目目录中使用
pyenv local
指定版本 - 使用
pyenv which python
查看当前使用的 Python 可执行文件路径
4. 高级功能
- 版本切换:
pyenv global 3.8.12
或pyenv shell 3.10.6
- 虚拟环境支持:可配合
virtualenv
实现更精细的环境管理 - 环境变量配置:确保
PYENV_ROOT
和PATH
正确设置
5. 注意事项 ⚠️
- 安装前请确认系统依赖已满足
- 避免在全局环境中安装第三方包
- 使用
pyenv rehash
更新命令补全缓存 - 如需更详细的配置,请参考 如何使用 virtualenv 配合 pyenv 进行更精细的环境管理