Ubuntu 系统 pyenv 部署与常用操作指南
环境准备与依赖安装
在 Ubuntu 16.04 环境下，pyenv 能够帮助我们实现多版本 Python 的并行管理，同时确保各版本下的第三方库相互隔离。首先需要安装编译 Python 所需的系统依赖：
# 刷新软件源并升级现有包
sudo apt-get update && sudo apt-get upgrade -y
# 安装构建依赖
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-devpyenv 安装流程
官方提供了自动化安装脚本，无需手动编译：
# 一键安装（脚本托管于 GitHub）
curl -fsSL https://pyenv.run | bash该命令实际等价于：
curl -fsSL https://github.com/pyenv/pyenv-installer/raw/master/bin/pyenv-installer | bashShell 环境配置
安装完成后，需将初始化命令追加至 shell 配置文件。以 Bash 为例：
# 编辑配置文件
cat >> ~/.bashrc << 'EOF'
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
eval "$(pyenv virtualenv-init -)"
EOF
# 重载配置
source ~/.bashrc验证安装是否成功：
echo $PATH | grep -q pyenv && echo "pyenv 已就绪"Python 版本管理
查看可安装版本
pyenv install -l | grep " 3\.[8-9]\| 3\.10"安装指定版本
由于 pyenv 默认从 GitHub 拉取源码，网络不稳定时可手动下载后放置于缓存目录：
# 创建缓存目录
mkdir -p ~/.pyenv/cache
# 手动下载源码包（示例：Python 3.9.16）
wget -q https://www.python.org/ftp/python/3.9.16/Python-3.9.16.tar.xz \
-O ~/.pyenv/cache/Python-3.9.16.tar.xz
# 执行安装
pyenv install 3.9.16 -v版本切换与验证
# 设置全局默认版本
pyenv global 3.9.16
# 仅为当前目录设置版本
pyenv local 3.8.10
# 查看当前生效版本
pyenv version
# 列出所有已安装版本
pyenv versions卸载与清理
# 删除指定版本
pyenv uninstall 3.8.10
# 更新版本数据库（安装新包后建议执行）
pyenv rehash虚拟环境管理
pyenv-virtualenv 插件提供了便捷的虚拟环境功能：
# 基于 3.9.16 创建名为 myproject 的虚拟环境
pyenv virtualenv 3.9.16 myproject
# 激活环境
pyenv activate myproject
# 退出环境
pyenv deactivate
# 删除虚拟环境
pyenv uninstall myproject常用维护命令
| 操作 | 命令 |
|---|---|
| 更新 pyenv 本身 | pyenv update |
| 完全移除 pyenv | rm -rf ~/.pyenv 并清理 ~/.bashrc 中的配置 |
| 查看命令帮助 | pyenv help <command> |
