Windows 系统安装pyenv

Windows 系统不能直接使用原版的 pyenv，因为它主要为 Linux 和 macOS 设计。不过，我们有一个专门为 Windows 设计的完美替代品：pyenv-win。

你可以把它看作是 pyenv 的 Windows 移植版，能让你方便地在 Windows 上安装、管理和切换多个 Python 版本。下面以 pyenv-win 为例，介绍几种安装方式。

这是最简单快捷的安装方式，适合大多数用户。

以管理员身份打开 PowerShell ：在 Windows 搜索栏中输入 PowerShell，右键点击 "Windows PowerShell"，然后选择 "以管理员身份运行"。
启用脚本执行策略 (如果尚未启用) ：

在打开的 PowerShell 窗口中，输入以下命令并回车。如果系统提示 RemoteSigned 相关错误，则需要执行此步骤。
powershell 复制代码
```
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
如果有需要，输入 Y 并回车确认。
执行安装命令 ：

复制并粘贴以下命令到 PowerShell 中，然后按回车执行。该脚本会自动从 GitHub 下载并安装 pyenv-win 的最新版本，并完成环境配置。
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"
```
重启 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 的根目录等相关变量。

我整理了一个配置表格，你可以参考下面的步骤操作：

变量名	变量值
`PYENV`	`C:\Users\你的用户名\.pyenv\pyenv-win` (你的解压路径)
`PYENV_ROOT`	`C:\Users\你的用户名\.pyenv\pyenv-win` (与上同)
`PYENV_HOME`	`C:\Users\你的用户名\.pyenv\pyenv-win` (与上同)

如果你已经安装了 Windows 的包管理器 Chocolatey，安装会异常简单。

以管理员身份打开 PowerShell。
安装 pyenv-win ：输入以下命令并回车即可。
powershell 复制代码
```
choco install pyenv-win
```
之后 Chocolatey 会自动完成安装和配置。

安装完成后，打开新的 PowerShell 或 CMD 窗口，输入以下命令验证是否成功。如果能看到版本号（如 3.1.1 等），就说明安装成功了。

bash 复制代码

pyenv --version

之后，你就可以使用 pyenv 来管理你的 Python 版本了：

查看可安装的 Python 版本列表 ：
bash 复制代码
```
pyenv install --list
```
安装特定版本的 Python ：
bash 复制代码
```
pyenv install 3.12.0
```
查看已安装的 Python 版本 ：
bash 复制代码
```
pyenv versions
```
切换全局 Python 版本 （所有终端都生效）：
bash 复制代码
```
pyenv global 3.12.0
```
为当前项目设置本地 Python 版本 （在当前文件夹下生效，会生成一个 .python-version 文件）：
bash 复制代码
```
pyenv local 3.8.10
```
仅对当前终端会话临时切换版本 ：
bash 复制代码
```
pyenv shell 3.9.5
```

关于 py.exe ：Windows 自带了 py.exe 启动器，无需任何配置即可用 py -3.9 等方式调用不同版本，适合轻度使用。而 pyenv 则提供了更强大的功能和更灵活的切换模式，适合需要严格管理多版本的场景。
关于版本切换不生效 ：如果切换版本后没有立即生效，可以尝试在新的终端窗口中操作，或者运行 pyenv rehash 命令来更新命令映射。
关于安装失败 ：如果 pyenv install 安装某个 Python 版本失败，很可能是系统缺少 Visual C++ 构建工具。你可以从这里下载安装：Visual Studio 生成工具。

除了 pyenv-win，你还可以考虑使用 uv 或 conda。uv 是一个用 Rust 编写的新一代 Python 项目管理工具，它以极快的速度和单一工具链的设计为特点，旨在统一多种工具的功能；而 conda 则是一个强大的跨平台环境和包管理器，特别适合科学计算场景。

希望这份指南对你有帮助！如果在安装过程中遇到任何问题，可以告诉我具体的报错信息，我会尽力协助你解决。