pyenv-win 项目安装指南：Windows 平台 Python 多版本管理利器-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01029/article/details/148487819

pyenv-win 项目安装指南：Windows 平台 Python 多版本管理利器

pyenv-win pyenv for Windows. pyenv is a simple python version management tool. It lets you easily switch between multiple versions of Python. It's simple, unobtrusive, and follows the UNIX tradition of single-purpose tools that do one thing well. 项目地址: https://gitcode.com/gh_mirrors/py/pyenv-win

前言

在 Python 开发中，经常需要同时管理多个 Python 版本。pyenv-win 是专为 Windows 平台设计的 Python 版本管理工具，它允许开发者在同一台机器上轻松安装、切换和管理多个 Python 版本。本文将详细介绍 pyenv-win 的各种安装方式，帮助开发者选择最适合自己的安装方法。

系统要求

在开始安装前，请确保您的系统满足以下要求：

Windows 7 或更高版本
PowerShell 5.1 或更高版本（推荐使用 PowerShell Core）
对于某些安装方式，可能需要预先安装 Git

安装方式选择

pyenv-win 提供多种安装方式，您可以根据自身情况选择：

PowerShell 一键安装（推荐新手使用）
Git 命令安装（适合熟悉 Git 的用户）
手动 ZIP 安装（适合受限环境）
pip 安装（适合已有 Python 环境的用户）
Chocolatey 安装（适合使用包管理器的用户）

详细安装指南

1. 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 并执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

然后重新运行安装命令。

2. Git 命令安装

适合已经安装 Git 的用户：

git clone https://github.com/pyenv-win/pyenv-win.git "%USERPROFILE%\.pyenv"

安装完成后，需要继续完成系统环境变量配置。

3. 手动 ZIP 安装

适用于无法使用 Git 或 PowerShell 的环境：

下载 pyenv-win 的 ZIP 压缩包
在用户目录下创建 .pyenv 文件夹
解压 ZIP 文件到 .pyenv 目录
确保 %USERPROFILE%\.pyenv\pyenv-win\bin 目录存在

4. pip 安装

已有 Python 环境的用户可以使用 pip 安装：

pip install pyenv-win --target %USERPROFILE%\.pyenv

如果遇到权限问题，可以尝试：

pip install pyenv-win --target %USERPROFILE%\.pyenv --no-user --upgrade

5. Chocolatey 安装

使用 Chocolatey 包管理器安装：

choco install pyenv-win

系统环境变量配置

无论采用哪种安装方式，安装完成后都需要配置环境变量：

PowerShell 配置方式

# 设置环境变量
[System.Environment]::SetEnvironmentVariable('PYENV',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")
[System.Environment]::SetEnvironmentVariable('PYENV_ROOT',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")
[System.Environment]::SetEnvironmentVariable('PYENV_HOME',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")

# 添加 PATH
[System.Environment]::SetEnvironmentVariable('path', $env:USERPROFILE + "\.pyenv\pyenv-win\bin;" + $env:USERPROFILE + "\.pyenv\pyenv-win\shims;" + [System.Environment]::GetEnvironmentVariable('path', "User"),"User")

手动配置方式

如果无法使用 PowerShell 命令，可以手动配置：

打开"环境变量"设置（在 Windows 搜索栏输入"环境变量"）
在"用户变量"或"系统变量"中添加以下变量：

| 变量名 | 值 | |------------|---------------------------------| | PYENV | C:\Users\用户名.pyenv\pyenv-win\ | | PYENV_HOME | C:\Users\用户名.pyenv\pyenv-win\ | | PYENV_ROOT | C:\Users\用户名.pyenv\pyenv-win\ |

在 PATH 变量中添加：

C:\Users\用户名\.pyenv\pyenv-win\bin
C:\Users\用户名\.pyenv\pyenv-win\shims

32 位 Python 支持

如果需要使用 32 位 Python 版本，可以安装 32-bit-train 分支：

Git 方式

cd %USERPROFILE%\.pyenv
git checkout -b 32bit-train origin/32bit-train

pip 方式

pip install pyenv-win==2.32.x --target %USERPROFILE%\.pyenv

验证安装

安装完成后，打开新的命令行窗口，执行以下命令验证安装：

pyenv --version

如果正确显示版本号，说明安装成功。

注意事项

Windows 10 1905 或更新版本的用户，可能需要禁用内置的 Python 启动器：
- 打开"开始"菜单 > "管理应用执行别名"
- 关闭 Python 相关的"应用安装程序"别名
安装完成后，建议重启命令行窗口使环境变量生效
如果在企业环境中使用，可能需要联系 IT 管理员获取权限

结语

pyenv-win 为 Windows 开发者提供了强大的 Python 版本管理能力。通过本文介绍的多种安装方式，您可以选择最适合自己环境的方法进行安装。安装完成后，您就可以轻松管理多个 Python 版本，为不同项目使用特定的 Python 环境了。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考