代码收藏家技术教程 2025-02-12

Pyenv：Python 版本管理的终极指南

在 Python 开发中，管理多个 Python 版本是一个常见的挑战。Pyenv 是一个强大的工具，允许开发者在同一台机器上轻松切换不同的 Python 版本。无论你是初学者还是专业开发者，Pyenv 都能帮助你更高效地管理 Python 版本。

本指南将详细介绍 Pyenv 的安装、使用、常见问题及高级功能，帮助你在不同项目中自由切换 Python 版本，提高开发效率。

1. 为什么选择 Pyenv？

在不同项目中，可能需要使用不同的 Python 版本。例如：

项目 A 依赖 Python 3.6

项目 B 需要 Python 3.9

你想要尝试最新的 Python 版本 3.12

如果使用系统自带的 Python，会遇到以下问题：

不能轻松切换不同的 Python 版本

使用 sudo 安装新版本容易破坏系统环境

影响全局 Python 依赖，导致冲突

Pyenv 解决了这些问题，让 Python 版本管理更加灵活和安全。

2. 如何安装 Pyenv？

2.1 在 macOS/Linux 上安装 Pyenv

使用 curl 或 git 安装 Pyenv：

curl https://pyenv.run | bash

或者使用 git 手动安装：

git clone https://github.com/pyenv/pyenv.git ~/.pyenv

然后在 ~/.bashrc 或 ~/.zshrc 中添加以下内容：

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"

然后重新加载 shell 配置文件：

source ~/.bashrc  # 或 source ~/.zshrc

2.2 在 Windows 上安装 Pyenv

Windows 用户可以使用 pyenv-win 版本。

git clone https://github.com/pyenv-win/pyenv-win.git %USERPROFILE%\.pyenv

然后配置环境变量，将以下路径添加到 PATH：

%USERPROFILE%\.pyenv\pyenv-win\bin
%USERPROFILE%\.pyenv\pyenv-win\shims

然后重新启动终端。

3. Pyenv 的基本使用

3.1 安装 Python 版本

查看可用的 Python 版本：

pyenv install --list

安装特定的 Python 版本，例如安装 Python 3.10.5：

pyenv install 3.10.5

3.2 设置默认 Python 版本

设置全局 Python 版本（影响所有终端）：

pyenv global 3.10.5

设置当前目录下的 Python 版本（仅影响当前项目）：

pyenv local 3.9.7

查看当前使用的 Python 版本：

pyenv version

3.3 卸载 Python 版本

如果某个 Python 版本不再需要，可以卸载它：

pyenv uninstall 3.8.12

4. Pyenv 的高级功能

4.1 使用 Pyenv Virtualenv 创建虚拟环境

pyenv-virtualenv 是 Pyenv 的插件，可以更方便地创建和管理虚拟环境。

安装 pyenv-virtualenv：

git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv

创建虚拟环境：

pyenv virtualenv 3.10.5 myenv

激活虚拟环境：

pyenv activate myenv

退出虚拟环境：

pyenv deactivate

4.2 自动切换 Python 版本

在项目目录下创建 .python-version 文件，并写入所需的 Python 版本：

echo "3.9.7" > .python-version

这样，每次进入该目录时，Pyenv 会自动切换到该版本。

4.3 解决 Pyenv 依赖问题

在安装 Python 版本时，可能会遇到缺少依赖的问题，建议在 Linux/macOS 上安装以下依赖：

sudo apt update && sudo apt 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 python-openssl git

5. Pyenv vs. Conda vs. venv

工具	适用场景	是否内置
Pyenv	多个 Python 版本管理	❌ 需安装
Conda	适用于数据科学，包含库管理功能	✅ Anaconda 自带
venv	项目级别的虚拟环境，轻量级	✅ Python 内置