Windows 系统不能直接使用原版的pyenv因为它主要为 Linux 和 macOS 设计。不过我们有一个专门为 Windows 设计的完美替代品pyenv-win。你可以把它看作是 pyenv 的 Windows 移植版能让你方便地在 Windows 上安装、管理和切换多个 Python 版本。下面以pyenv-win为例介绍几种安装方式。⚙️ 准备工作了解 pyenv-win它是什么一个让你在 Windows 系统中轻松管理多个 Python 版本的工具。系统要求Windows 10 或更高版本建议更新到最新版。管理员权限后续的安装和配置步骤需要你的 Windows 账户具有管理员权限。关于 Git虽然 Git 不是必需的但如果你已经安装了 Git后续更新pyenv-win会更方便。 方法一PowerShell 自动安装 (最推荐)这是最简单快捷的安装方式适合大多数用户。以管理员身份打开 PowerShell在 Windows 搜索栏中输入PowerShell右键点击 “Windows PowerShell”然后选择“以管理员身份运行”。启用脚本执行策略 (如果尚未启用)在打开的 PowerShell 窗口中输入以下命令并回车。如果系统提示RemoteSigned相关错误则需要执行此步骤。Set-ExecutionPolicyRemoteSigned-Scope CurrentUser如果有需要输入Y并回车确认。执行安装命令复制并粘贴以下命令到 PowerShell 中然后按回车执行。该脚本会自动从 GitHub 下载并安装pyenv-win的最新版本并完成环境配置。Invoke-WebRequest-UseBasicParsing-Urihttps://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1-OutFile./install-pyenv-win.ps1;./install-pyenv-win.ps1重启 PowerShell安装完成后需要关闭并重新打开一个新的 PowerShell 或命令提示符 (CMD) 窗口以使环境变量生效。 方法二手动下载安装 (适合网络受限或无管理员权限)如果自动安装脚本执行失败可以选择手动安装。下载安装包访问pyenv-win在GitHub 的 Releases 页面https://github.com/pyenv-win/pyenv-win/releases下载最新版本的pyenv-win-版本号.zip文件。解压文件将下载的 ZIP 文件解压到你希望安装pyenv-win的目录例如C:\Users\你的用户名\.pyenv。配置环境变量这是手动安装最关键的一步要确保系统能找到pyenv命令。第一步手动添加pyenv的根目录等相关变量。我整理了一个配置表格你可以参考下面的步骤操作变量名变量值PYENVC:\Users\你的用户名\.pyenv\pyenv-win(你的解压路径)PYENV_ROOTC:\Users\你的用户名\.pyenv\pyenv-win(与上同)PYENV_HOMEC:\Users\你的用户名\.pyenv\pyenv-win(与上同)第二步找到系统变量里的Path并编辑新增以下两条路径%PYENV%\bin%PYENV%\shims。 方法三通过 Chocolatey 安装 (适合喜欢包管理器的用户)如果你已经安装了 Windows 的包管理器 Chocolatey安装会异常简单。以管理员身份打开 PowerShell。安装 pyenv-win输入以下命令并回车即可。choco install pyenv-win之后 Chocolatey 会自动完成安装和配置。✅ 验证与快速开始安装完成后打开新的PowerShell 或 CMD 窗口输入以下命令验证是否成功。如果能看到版本号如3.1.1等就说明安装成功了。pyenv--version之后你就可以使用pyenv来管理你的 Python 版本了查看可安装的 Python 版本列表pyenvinstall--list安装特定版本的 Pythonpyenvinstall3.12.0查看已安装的 Python 版本pyenv versions切换全局 Python 版本所有终端都生效pyenv global3.12.0为当前项目设置本地 Python 版本在当前文件夹下生效会生成一个.python-version文件pyenvlocal3.8.10仅对当前终端会话临时切换版本pyenv shell3.9.5⚠️ 常见问题与建议关于py.exeWindows 自带了py.exe启动器无需任何配置即可用py -3.9等方式调用不同版本适合轻度使用。而pyenv则提供了更强大的功能和更灵活的切换模式适合需要严格管理多版本的场景。关于版本切换不生效如果切换版本后没有立即生效可以尝试在新的终端窗口中操作或者运行pyenv rehash命令来更新命令映射。关于安装失败如果pyenv install安装某个 Python 版本失败很可能是系统缺少 Visual C 构建工具。你可以从这里下载安装Visual Studio 生成工具。 其他选择除了pyenv-win你还可以考虑使用uv或conda。uv是一个用 Rust 编写的新一代 Python 项目管理工具它以极快的速度和单一工具链的设计为特点旨在统一多种工具的功能而conda则是一个强大的跨平台环境和包管理器特别适合科学计算场景。希望这份指南对你有帮助如果在安装过程中遇到任何问题可以告诉我具体的报错信息我会尽力协助你解决。