你是否遇到过这些问题？

• 项目需要 Python 3.7，但系统默认是 3.10，切换版本太麻烦！
• 同时开发多个项目，不同依赖环境频繁冲突！
• 手动安装 Python 版本，环境变量配置到怀疑人生！

今天我们来使用 pyenv-win 一招搞定这些问题！

什么是 pyenv-win？

pyenv-win 是专为 Windows 系统设计的 Python 版本管理工具(pyenv Windows版本)，支持：
一键安装/卸载任意 Python 版本
全局/本地环境自由切换
告别项目Python版本冲突

三步安装 pyenv-win

方法 1：用 pip 直接安装（需要已安装Python）

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

提示：将 %USERPROFILE% 替换为自定义路径（如 D:\pyenv）。

方法 2：下载源码手动安装

1. 下载 pyenv-win 源码包并解压。
2. 复制所有文件到目标目录（如 D:\pyenv\.pyenv）。

方法 3：Git 克隆安装

cd D:\pyenv\.pyenv
git clone https://github.com/pyenv-win/pyenv-win.git

配置环境变量（关键步骤！）

1. 添加系统变量：
2. PYENV 和 PYENV_HOME：设置为安装路径（如 D:\pyenv\.pyenv\pyenv-win）。
3. PATH：追加 D:\pyenv\.pyenv\pyenv-win\bin 和 D:\pyenv\.pyenv\pyenv-win\shims。
4. 以管理员身份运行 PowerShell，执行以下命令：

[System.Environment]::SetEnvironmentVariable('PYENV', 'D:\pyenv\.pyenv\pyenv-win', 'Machine')
[System.Environment]::SetEnvironmentVariable('PATH', 'D:\pyenv\.pyenv\pyenv-win\bin;D:\pyenv\.pyenv\pyenv-win\shims;' + [System.Environment]::GetEnvironmentVariable('PATH', 'Machine'), 'Machine')

1. 验证安装：

pyenv --version

1. 若显示版本号，恭喜配置成功！

常见问题急救包

问题：运行 pyenv 报错“无法加载文件 pyenv.ps1”。
解决：

1. 管理员身份打开 PowerShell。

输入： Set-ExecutionPolicy RemoteSigned

1. 输入 Y 确认即可。

高频命令速查表

实践案例：多版本 Python 项目管理

场景 1：为不同项目指定独立 Python 版本

假设你有两个项目：

• 项目 A：需要 Python 3.8.0
• 项目 B：需要 Python 3.9.6

操作步骤：

1. 进入项目 A 的根目录，执行：

pyenv local 3.8.0

此时项目 A 默认使用 Python 3.8.0。

2. 进入项目 B 的根目录，执行：

pyenv local 3.9.6

此时项目 B 默认使用 Python 3.9.6。

3. 验证：

• 在项目 A 目录下运行 python --version，输出应为 Python 3.8.0。
• 在项目 B 目录下运行 python --version，输出应为 Python 3.9.6。

场景 2：安装依赖不冲突

在项目 A 中安装依赖：

1. 进入项目 A 目录，执行：

pyenv exec pip install -r requirements.txt

此时依赖会安装到 Python 3.8.0 的环境中，不会影响其他项目。

2. 在项目 B 中安装依赖：

pyenv exec pip install -r requirements.txt

依赖会安装到 Python 3.9.6 的环境中，与项目 A 完全隔离。

高效技巧

• 项目隔离：在项目根目录执行 pyenv local 3.8.0，确保不同项目使用独立 Python 环境。
• 一键安装依赖：用 pyenv exec pip install -r requirements.txt 避免依赖冲突。

结语

掌握 pyenv-win，从此 Python 版本管理就像“开关灯”一样简单！赶紧动手试试，评论区等你晒出成功截图！

如觉有用请收藏并转给需要的伙伴，大家一起提升Python版本管理效率！

持续学习、适应变化、记录点滴、复盘反思、成长进步