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

pyenv-win是一款专为Windows系统设计的Python版本管理工具，它让开发者能够轻松切换多个Python版本，实现项目环境的隔离与灵活配置。作为pyenv在Windows平台的移植版本，它继承了简洁、无侵入的设计理念，完美遵循UNIX工具的单一职责原则。

为什么选择pyenv-win？

在Windows系统上管理多个Python版本曾是一件棘手的事情，手动切换环境变量不仅繁琐，还容易导致版本冲突。pyenv-win通过以下核心优势解决了这些痛点：

• 多版本并行管理：在同一台电脑上同时安装Python 2.7、3.8、3.10等多个版本，按需切换
• 项目级环境隔离：为不同项目指定专属Python版本，避免依赖冲突
• 自动化版本切换：通过配置文件自动识别项目所需Python版本
• 无需管理员权限：所有操作在用户空间完成，不影响系统全局配置

快速安装指南

1. PowerShell一键安装（推荐）

打开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"

2. 验证安装

安装完成后，关闭并重新打开终端，执行以下命令验证：

pyenv --version

看到版本信息输出即表示安装成功。

核心功能使用教程

查看可安装的Python版本

列出所有pyenv-win支持的Python版本：

pyenv install -l

如需筛选特定版本（如3.8系列），可使用：

pyenv install -l | findstr 3.8

安装指定Python版本

安装Python 3.9.7的命令如下：

pyenv install 3.9.7

⚠️ 注意：部分版本可能会弹出安装向导，保持默认设置点击下一步即可完成安装

切换Python版本

设置全局默认Python版本：

pyenv global 3.9.7

为当前项目设置局部版本（会在当前目录创建.python-version文件）：

pyenv local 3.8.10

在当前终端会话临时切换版本：

pyenv shell 3.10.2

管理已安装版本

查看所有已安装的Python版本：

pyenv versions

卸载指定版本：

pyenv uninstall 3.7.9

高级配置与技巧

环境变量设置

pyenv-win安装完成后会自动配置以下环境变量：

• PYENV_HOME: 指向pyenv-win安装目录（通常为C:\Users\<用户名>\.pyenv\pyenv-win）
• PATH: 添加了%PYENV_HOME%\bin和%PYENV_HOME%\shims路径

如需手动调整，可通过系统环境变量设置界面进行修改。

升级pyenv-win

根据安装方式不同，升级方法也有所区别：

• pip安装方式：

  pip install --upgrade pyenv-win
  

• Git安装方式：

  cd %USERPROFILE%\.pyenv\pyenv-win
  git pull
  

解决常见问题

1. 安装失败：确保网络连接正常，或尝试使用本地安装包
2. 版本切换不生效：检查是否关闭并重新打开终端，或执行pyenv rehash刷新配置
3. 权限问题：无需以管理员身份运行终端，所有操作在用户权限下即可完成

命令参考速查表

命令	功能描述
pyenv versions	列出所有已安装版本
pyenv install <version>	安装指定版本
pyenv uninstall <version>	卸载指定版本
pyenv global <version>	设置全局版本
pyenv local <version>	设置局部版本
pyenv shell <version>	设置会话版本
pyenv rehash	更新shims（安装新包后执行）
pyenv which python	显示当前python路径

总结

pyenv-win为Windows平台的Python开发者提供了简单而强大的版本管理解决方案，通过直观的命令行操作，让多版本Python环境的管理变得轻松高效。无论是个人学习还是企业项目开发，它都能帮助你构建清晰、隔离的开发环境，提高工作效率。

官方文档：docs/installation.md 核心命令实现：pyenv-win/libexec/

立即尝试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