pyenv

概述

pyenv 是一款轻量级的 Python 版本管理工具，核心作用是：在同一台机器上灵活切换、安装、管理多个 Python 版本，且各版本的依赖包（site-packages）完全隔离，互不干扰。

安装

brew install pyenv

# 编辑 zsh 配置文件
echo 'export PATH="$HOME/.pyenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.zshrc

# 生效配置
source ~/.zshrc

命令

列出所有可安装的python版本

pyenv install --list

# 排除包含 dev/rc/beta 的版本
pyenv install -l | grep -vE "(dev|rc|beta)"  

安装指定 Python 版本

# 安装 Python 3.11.4
pyenv install 3.11.4 

查看已安装的 Python 版本

# 列出所有可用版本，* 表示当前生效版本
pyenv versions

切换版本：

# 全局默认使用 3.11.4
pyenv global 3.11.4
# 当前项目目录使用 3.8.17（会生成 .python-version 文件）
pyenv local 3.8.17
# 仅当前终端会话使用 3.10.12
pyenv shell 3.10.12

虚拟环境：

# 安装插件
brew install pyenv-virtualenv

# 创建虚拟环境（基于当前激活的 Python 版本）
pyenv virtualenv myenv

# 激活虚拟环境
pyenv activate myenv

# 退出虚拟环境
pyenv deactivate

删除版本：

先切换到使用的版本上，再执行删除

pyenv uninstall 3.9.17

删除虚拟环镜：

# 查看所有虚拟环境
pyenv virtualenvs 
# 语法 1
pyenv virtualenv-delete <虚拟环境名>
# 语法 2
pyenv uninstall <版本号>/envs/<虚拟环境名>