【Python开发者必看】Windows下Python版本管理器Pyenv安装使用，轻松管理Python版本的入门与进阶指南，从此告别Python环境不兼容的噩梦

目录

一、为什么需要Pyenv

二、Windows下Pyenv安装前准备

（一）前置依赖  

1、Visual C++ Redistributable  

2、OpenSSL库（可选但推荐）  

三、Pyenv核心安装步骤（推荐方案）  

（一）通过Chocolatey安装（最简方式）  

（二）手动安装（无包管理器场景，也是博主常用场景）  

1、下载Pyenv-Win源码

2、 配置环境变量  

四、Pyenv基础使用指南  

（一）查看版本管理状态

（二）查看Python可安装版本

（三）安装Python版本

（四）切换版本  

1、 全局版本（系统级）

2、局部版本（项目级，需在项目根目录操作）  

3、临时版本（单次命令生效）

五、进阶技巧：虚拟环境与插件扩展

（一）pyenv 创建虚拟环境

（二）集成pyenv-virtualenv插件（推荐）  

1、安装插件

2、创建虚拟环境

3、激活/停用环境

4、列出所有虚拟环境

（三）解决编译错误（以PyTorch为例）  

（四）版本别名管理  

六、常见问题与解决方案  

（一）安装Python时卡在 “Fetching”  

（二）切换版本后命令行仍显示旧版本  

（三）虚拟环境冲突  

七、Windows与macOS/Linux的差异 

八、结束语

九、官方文档

---

一、为什么需要Pyenv

在Windows开发中，不同项目可能依赖不同Python版本（如3.8 vs 3.11），直接切换容易引发环境冲突。Pyenv是一款轻量级版本管理工具，支持：  

1. 多版本共存：同时安装Python 3.6/3.9/3.12等多个版本  
2. 全局/局部版本切换：项目级独立配置，避免污染系统环境  
3. 插件扩展：支持虚拟环境（如pyenv-virtualenv）、版本编译等高级功能