当然!以下是使用 pyenv
的详细教程,包括安装、配置和常用命令。pyenv
是一个强大的 Python 版本管理工具,特别适合需要切换多个 Python 版本的场景。
1. 安装 pyenv
在 macOS/Linux 上安装
-
安装依赖工具:
- macOS:
brew install openssl readline sqlite3 xz zlib
- Ubuntu/Debian:
sudo apt-get install -y make build-essential libssl-dev zlib1g-dev \ libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm \ libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev \ liblzma-dev python3-openssl git
- macOS:
-
安装
pyenv
:curl https://pyenv.run | bash
-
配置 Shell 环境:
- 如果你使用
bash
,将以下内容添加到~/.bashrc
或~/.bash_profile
:export PYENV_ROOT="$HOME/.pyenv" export PATH="$PYENV_ROOT/bin:$PATH" eval "$(pyenv init --path)" eval "$(pyenv init -)"
- 如果你使用
zsh
,将以上内容添加到~/.zshrc
。
- 如果你使用
-
重启终端或运行以下命令使配置生效:
exec $SHELL
在 Windows 上安装
Windows 上的 pyenv
是通过 pyenv-win
实现的。
-
打开 PowerShell,运行以下命令安装
pyenv-win
:Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"
-
安装完成后,重启 PowerShell。
-
验证安装:
pyenv --version
2. 使用 pyenv
管理 Python 版本
安装 Python 版本
-
查看可安装的 Python 版本:
pyenv install --list
-
安装指定版本的 Python:
pyenv install 3.9.7
-
安装完成后,查看已安装的 Python 版本:
pyenv versions
切换 Python 版本
-
设置全局 Python 版本(全局生效):
pyenv global 3.9.7
-
设置局部 Python 版本(仅在当前目录生效):
pyenv local 3.8.12
-
使用某个 Python 版本运行命令(临时生效):
pyenv shell 3.7.12
卸载 Python 版本
- 卸载指定版本的 Python:
pyenv uninstall 3.9.7
3. 使用 pyenv-virtualenv
管理虚拟环境
pyenv-virtualenv
是 pyenv
的插件,用于管理虚拟环境。
安装 pyenv-virtualenv
-
安装插件:
git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
-
配置 Shell 环境:
- 在
~/.bashrc
或~/.zshrc
中添加:eval "$(pyenv virtualenv-init -)"
- 在
-
重启终端或运行:
exec $SHELL
创建虚拟环境
-
基于某个 Python 版本创建虚拟环境:
pyenv virtualenv 3.9.7 myenv
-
激活虚拟环境:
pyenv activate myenv
-
退出虚拟环境:
pyenv deactivate
-
删除虚拟环境:
pyenv uninstall myenv
4. 常用命令总结
命令 | 说明 |
---|---|
pyenv install --list | 查看可安装的 Python 版本 |
pyenv install <version> | 安装指定版本的 Python |
pyenv versions | 查看已安装的 Python 版本 |
pyenv global <version> | 设置全局 Python 版本 |
pyenv local <version> | 设置局部 Python 版本 |
pyenv shell <version> | 临时使用某个 Python 版本 |
pyenv uninstall <version> | 卸载指定版本的 Python |
pyenv virtualenv <version> <name> | 创建虚拟环境 |
pyenv activate <name> | 激活虚拟环境 |
pyenv deactivate | 退出虚拟环境 |
5. 示例工作流
假设你需要开发一个项目,要求 Python 3.8 和特定的依赖:
-
安装 Python 3.8:
pyenv install 3.8.12
-
创建虚拟环境:
pyenv virtualenv 3.8.12 myproject-env
-
激活虚拟环境:
pyenv activate myproject-env
-
安装项目依赖:
pip install -r requirements.txt
-
退出虚拟环境:
pyenv deactivate
6. 注意事项
- 在 Windows 上,
pyenv-win
的功能可能不如 macOS/Linux 上的pyenv
完善。 - 如果遇到网络问题导致安装失败,可以尝试设置代理或使用镜像源。