一、安装 pyenv-win
方法 1:使用 PowerShell 自动安装(推荐)
- 以管理员身份打开 PowerShell(确保已启用执行脚本权限)
- 安装完成后,关闭并重新打开终端使配置生效
运行以下命令(自动克隆仓库并配置环境变量):
Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"
方法 2:手动安装(适用于网络受限环境)
- 从 pyenv-win 仓库 下载源码(点击 Code → Download ZIP)
- 解压文件,将文件夹重命名为
pyenv-win - 将文件夹移动到合适位置(推荐
C:\Users\<你的用户名>\.pyenv\pyenv-win) - 手动配置环境变量:
- 新增系统变量
PYENV,值为C:\Users\<你的用户名>\.pyenv\pyenv-win - 在系统变量
Path中添加%PYENV%\bin和%PYENV%\shims
- 新增系统变量
验证安装
打开新终端,运行以下命令,若显示版本号则安装成功:
pyenv --version
二、基本使用命令
1. 查看可安装的 Python 版本
pyenv install --list # 列出所有可安装版本(较多,可过滤查看)
pyenv install --list | findstr "3.11" # 过滤查看 3.11.x 版本(Windows 用 findstr)
2. 安装指定 Python 版本
pyenv install 3.11.4 # 安装 3.11.4 版本(版本号需精确匹配列表中的名称)
注意:安装过程可能需要联网下载 Python 安装包。若安装失败,可能需要安装 Visual C++ 构建工具。
3. 查看已安装的 Python 版本
pyenv versions # 列出所有已安装版本(* 表示当前活跃版本)
4. 切换 Python 版本
pyenv global 3.11.4 # 设置全局默认版本(所有终端生效)
pyenv local 3.9.13 # 设置当前目录局部版本(仅当前项目生效,会生成 .python-version 文件)
pyenv shell 3.8.10


