你是否遇到过这些问题？
- 项目需要 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：下载源码手动安装
- 下载 pyenv-win 源码包并解压。
- 复制所有文件到目标目录（如 D:\pyenv\.pyenv）。
方法 3：Git 克隆安装
cd D:\pyenv\.pyenv
git clone https://github.com/pyenv-win/pyenv-win.git?? 配置环境变量（关键步骤！）
- 添加系统变量：
- PYENV 和 PYENV_HOME：设置为安装路径（如 D:\pyenv\.pyenv\pyenv-win）。
- PATH：追加 D:\pyenv\.pyenv\pyenv-win\bin 和 D:\pyenv\.pyenv\pyenv-win\shims。
- 以管理员身份运行 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')- 验证安装：
pyenv --version- 若显示版本号，恭喜配置成功！
常见问题急救包
问题：运行 pyenv 报错“无法加载文件 pyenv.ps1”。
解决：
- 管理员身份打开 PowerShell。
输入： Set-ExecutionPolicy RemoteSigned- 输入 Y 确认即可。
高频命令速查表
功能 | 命令 | 示例 |
查看所有 Python 版本 | pyenv install --list | |
安装指定版本 | pyenv install <版本号> | pyenv install 3.9.6 |
卸载版本 | pyenv uninstall <版本号> | pyenv uninstall 3.8.0 |
设置全局默认版本 | pyenv global <版本号> | pyenv global 3.9.6 |
设置当前目录版本 | pyenv local <版本号> | pyenv local 3.7.12 |
刷新环境 | pyenv rehash |
实践案例：多版本 Python 项目管理
场景 1：为不同项目指定独立 Python 版本
假设你有两个项目：
- 项目 A：需要 Python 3.8.0
- 项目 B：需要 Python 3.9.6
操作步骤：
- 进入项目 A 的根目录，执行：
pyenv local 3.8.0此时项目 A 默认使用 Python 3.8.0。
- 进入项目 B 的根目录，执行：
pyenv local 3.9.6此时项目 B 默认使用 Python 3.9.6。
- 验证：
- 在项目 A 目录下运行 python --version，输出应为 Python 3.8.0。
- 在项目 B 目录下运行 python --version，输出应为 Python 3.9.6。
场景 2：安装依赖不冲突
在项目 A 中安装依赖：
- 进入项目 A 目录，执行：
pyenv exec pip install -r requirements.txt此时依赖会安装到 Python 3.8.0 的环境中，不会影响其他项目。
- 在项目 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版本管理效率！
持续学习、适应变化、记录点滴、复盘反思、成长进步