### pyenv 在 Python 中的安装与使用教程 #### 一、pyenv 的简介 `pyenv` 是一种用于管理和切换 Python 不同版本的强大工具。它允许开发者在同一台机器上轻松安装和管理多个 Python 版本，而不会相互干扰。 --- #### 二、不同操作系统下的 `pyenv` 安装方式 ##### **Windows 系统** 对于 Windows 用户来说，推荐使用 `pyenv-win` 工具来实现相同的功能[^5]。 1. 下载并解压 `pyenv-win` 文件夹至指定路径（如：`D:\Program_Files\pyenv`），同时创建一个专门存储 Python 版本的目录（如：`D:\Program_Files\python`）[^3]。 2. 配置环境变量： - 将 `%PYENV%` 设置为 `pyenv` 所在路径（例如：`D:\Program_Files\pyenv`）。 - 更新系统的 PATH 变量，加入以下内容： ``` %PYENV%\bin;%PYENV%\shims; ``` 验证安装成功的方法是在终端运行以下命令： ```bash pyenv --version ``` 如果显示版本号，则说明安装完成。 --- ##### **macOS 系统** 在 macOS 上可以通过 Homebrew 轻松安装 `pyenv`[^2]。 1. 使用 Homebrew 安装 `pyenv`： ```bash brew install pyenv ``` 2. 修改 `.zshrc` 文件以加载 `pyenv` 初始化脚本： ```bash echo 'eval "$(pyenv init --path)"' >> ~/.zshrc source ~/.zshrc ``` 此时即可通过 `pyenv` 命令操作 Python 版本。 --- ##### **Linux (CentOS/Ubuntu)** 系统 在 Linux 平台上也可以通过源码编译或者直接克隆 GitHub 仓库的方式安装 `pyenv`[^4]。 1. 克隆官方仓库到默认 `$HOME/.pyenv` 目录： ```bash curl https://pyenv.run | bash ``` 2. 如果希望自定义安装位置，设置 `PYENV_ROOT` 环境变量后再执行上述命令： ```bash export PYENV_ROOT="/usr/local/pyenv" curl https://pyenv.run | bash ``` 3. 配置环境变量，在用户的 shell 配置文件中添加以下内容（如 `.bashrc` 或 `.zshrc`）： ```bash export PATH="$PYENV_ROOT/bin:$PATH" eval "$(pyenv init --path)" ``` 完成后重新加载配置文件： ```bash source ~/.bashrc ``` --- #### 三、pyenv 的基本使用方法 以下是常见的 `pyenv` 操作指令及其功能： | 指令 | 功能描述 | |-------------------------------|-------------------------------------------------------------------------| | `pyenv install --list` | 列出所有可用的 Python 版本 | | `pyenv install <version>` | 安装指定版本的 Python（如：`pyenv install 3.10.1`） | | `pyenv versions` | 显示已安装的所有 Python 版本 | | `pyenv version` | 查看当前使用的 Python 版本 | | `pyenv local <version>` | 设定当前工作目录中的 Python 默认版本 | | `pyenv global <version>` | 设定全局范围内的 Python 默认版本 | | `pyenv shell <version>` | 临时设定本次 Shell 会话中的 Python 版本 | | `pyenv uninstall <version>` | 卸载某个特定版本的 Python | 示例代码展示如何查看当前 Python 解释器的位置： ```bash pyenv which python ``` 这有助于确认所调用的具体解释器路径[^1]。 --- #### 四、注意事项 - 在某些情况下可能需要额外安装依赖项才能顺利构建 Python 版本。例如，在 Ubuntu/Linux 系统中需提前安装开发库： ```bash sudo apt-get update && sudo apt-get install 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 python-openssl git ``` - 对于虚拟环境的支持，可以配合 `pyenv-virtualenv` 插件一起使用，从而更方便地隔离项目所需的依赖环境。 --- ###