一、安装 pyenv-win
- 从 GitHub 仓库下载源码(点击 Code → Download ZIP) 下载地址:https://github.com/pyenv-win/pyenv-win
- 解压文件,将文件夹重命名为
pyenv(例如D:\ProgramFiles\pyenv)。 - 配置环境变量:
- 新增系统变量
PYENV,值为pyenv的地址D:\ProgramFiles\pyenv\pyenv-win。 - 在系统变量
Path中添加%PYENV%\bin和%PYENV%\shims。
- 新增系统变量
验证安装:
cmd 终端执行 pyenv,出现如下界面说明安装成功。
二、基本使用命令
- 查看可安装的 Python 版本
pyenv install --list # 列出所有可安装版本 pyenv install --list | findstr "3.12" # 过滤查看特定版本 - 安装指定 Python 版本
pyenv install 3.12.8 # 版本号需精确匹配列表中的名称 - 查看已安装的 Python 版本
pyenv versions # 列出所有已安装版本(* 表示当前活跃版本) - 切换 Python 版本
pyenv global 3.11.4 # 设置全局默认版本(所有终端生效) pyenv local 3.9.13 # 设置当前目录局部版本(生成 .python-version 文件) pyenv shell 3.8.10 # 设置当前终端会话临时版本 - 卸载 Python 版本
pyenv uninstall 3.7.9 - 常用命令参考
commands: 列出所有可用的 pyenv 命令duplicate: 创建一个重复的 python 环境local: 设置或显示特定于本地应用程序的 Python 版本global: 设置或显示全局 Python 版本shell: 设置或显示特定于 shell 的 Python 版本install: Python 构建安装 Python 版本uninstall: 卸载特定的 Python 版本update: 更新缓存的版本数据库rehash: 重新安装 pyenv 垫片vname: 显示当前的 Python 版本version: 显示当前 Python 版本及其来源versions: 列出 pyenv 可用的所有 Python 版本exec: 运行可执行文件which: 显示可执行文件的完整路径whence: 列出包含给定可执行文件的所有 Python 版本
三、镜像源配置
Python 镜像地址:

