Windows 系统 Python 版本管理工具 pyenv-win 安装与配置

一、安装 pyenv-win

1. 从 GitHub 仓库下载源码（点击 Code → Download ZIP） 下载地址：https://github.com/pyenv-win/pyenv-win
2. 解压文件，将文件夹重命名为 pyenv（例如 D:\ProgramFiles\pyenv）。
3. 配置环境变量：
   • 新增系统变量 PYENV，值为 pyenv 的地址 D:\ProgramFiles\pyenv\pyenv-win。
   • 在系统变量 Path 中添加 %PYENV%\bin 和 %PYENV%\shims。

验证安装： cmd 终端执行 pyenv，出现如下界面说明安装成功。

二、基本使用命令

1. 查看可安装的 Python 版本

   pyenv install --list # 列出所有可安装版本
   pyenv install --list | findstr "3.12" # 过滤查看特定版本
   

2. 安装指定 Python 版本

   pyenv install 3.12.8 # 版本号需精确匹配列表中的名称
   

3. 查看已安装的 Python 版本

   pyenv versions # 列出所有已安装版本（* 表示当前活跃版本）
   

4. 切换 Python 版本

   pyenv global 3.11.4 # 设置全局默认版本（所有终端生效）
   pyenv local 3.9.13 # 设置当前目录局部版本（生成 .python-version 文件）
   pyenv shell 3.8.10 # 设置当前终端会话临时版本
   

5. 卸载 Python 版本

   pyenv uninstall 3.7.9
   

6. 常用命令参考
   • 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 镜像地址：

• https://mirrors.huaweicloud.com/python/
• https://registry.npmmirror.com/binary.html?path=python/

Pip 库的国内镜像：

• 清华：https://pypi.tuna.tsinghua.edu.cn/simple/
• 中科大：https://pypi.mirrors.ustc.edu.cn/simple/
• 阿里云：http://mirrors.aliyun.com/pypi/simple/

查看/修改 pip 默认源：

1. 查看当前 pip 源：

   pip config list
   

2. 永久修改 pip 源：

   pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple