跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

Python 多环境管理工具 pyenv-win 安装与使用

pyenv-win 是一款在 Windows 系统上管理 Python 版本的轻量级工具,支持在同一台计算机上安装并切换多个 Python 版本。 pyenv-win 的安装步骤、环境变量配置、常用命令、版本安装及常见问题处理,并演示了如何在 PyCharm 中配置解释器。通过该工具,开发者可以避免不同项目间的依赖冲突,特别适用于机器学习等需要多版本环境的场景。

1qazxsw2发布于 2025/2/7更新于 2026/9/870 浏览
Python 多环境管理工具 pyenv-win 安装与使用

pyenv-win 简介

什么是 pyenv-win:是一个在 Windows 系统上管理 Python 版本的工具。它是 pyenv 的 Windows 版本,旨在提供类似于 Unix/Linux 系统上的 pyenv 功能。允许用户在同一台计算机上安装多个 Python 版本,并轻松切换它们之间的环境。使用 pyenv-win,可以方便地安装、管理和切换各种 Python 版本,而无需手动更改系统环境变量。

pyenv-win 应用场景:pyenv-win 可以应用于各种领域,但在机器学习方面尤其有用。在机器学习领域,通常需要使用多个 Python 库和工具来进行数据处理、模型训练和预测等任务。不同的库和工具可能对不同版本的 Python 有不同的要求,因此使用 pyenv-win 可以轻松地管理这些不同版本的 Python,并切换到特定的环境,以满足不同的需求。

pyenv-win 的特点:轻量级的 Python 版本管理工具,相比于同样为 Python 管理工具 Anaconda,体积更为小巧,并且还提供了虚拟环境的支持,可以为不同的项目创建独立的 Python 环境,从而避免不同项目之间的依赖冲突。这对于机器学习项目来说尤其重要,因为不同的项目可能需要不同版本的 Python 和不同的库。

总之,pyenv-win 是一个非常有用的工具,可以帮助机器学习开发者轻松管理多个 Python 版本和虚拟环境,从而提高开发效率和项目可维护性。

pyenv-win 安装

打开 GitHub 仓库,点击 Code,然后再点击 Download ZIP 进行下载压缩包。

将 pyenv-win 压缩包解压到不带中文的目录下,并将文件夹名称重命名为 pyenv。

打开文件夹找到 bin 目录,并将文件夹路径进行复制。

配置环境变量

电脑搜索框输入'高级系统设置',打开后点击环境变量。

在系统变量中点击新建,然后将 PYENV 添加到系统变量中,并配置上面复制的目录,点击确认。

在系统变量中找到 Path 这个变量,双击打开,将下面这两行路径加进去,然后点击确定,点击完里面的确定再点击环境变量的确定。

%PYENV%\bin
%PYENV%\shims

至此环境变量配置完成,为了验证我们是否配置成功,cmd 终端执行 pyenv,出现如下界面说明我们已经安装成功。

pyenv 的基本命令

以下 pyenv 的常用命令,掌握这些基本的命令之后,就可以在项目中轻松切换 Python 版本:

查看 pyenv-win 支持的 Python 版本列表:

pyenv install --list

查看当前 Python 对应版本:

pyenv version

查看电脑安装的所有 Python 版本:

pyenv versions

安装指定版本 || 也可以在一个命令中安装多个版本:

pyenv install <version> || pyenv install <version> <version>

卸载指定版本:

pyenv uninstall <version>

将 Python 版本设置为全局版本 (默认使用的 Python 版本) 注意:必须先安装该版本。

pyenv global <version>

设置本地版本 (当在此文件夹中调用 Python 时,都会使用给定的版本。) 注意:必须先安装该版本。

pyenv local <version>

查看 Python 版本来核对:

python -V

官方网站给出的 pyenv-win 命令如下,大家可自行了解:

commands  -------------列出所有可用的 pyenv 命令
duplicate   -------------创建一个重复的 python 环境
local        --------------设置或显示特定于本地应用程序的 Python 版本
global     --------------设置或显示全局 Python 版本
shell        --------------设置或显示特定于 shell 的 Python 版本
install      --------------Python 构建安装 Python 版本
uninstall    -------------卸载特定的 Python 版本
update      -------------更新缓存的版本数据库
rehash      -------------重新安装 pyenv 垫片(安装可执行文件后运行此操作)
vname       -------------显示当前的 Python 版本
version      -------------显示当前 Python 版本及其来源
version-name ----------------显示当前的 Python 版本
versions    -----------------列出 pyenv 可用的所有 Python 版本
exec        -----------------通过首先准备路径来运行可执行文件,以便选定的 Python
which       -------------- 显示可执行文件的完整路径
whence     ---------------------列出包含给定可执行文件的所有 Python 版本

pyenv 安装 py 环境

使用 pyenv 安装 py 环境是不需要我们再去手动设置 python 环境变量的,pyenv 会帮我们自动设置好,接下来我们开始安装 python 环境,如下:

  1. 查看 pyenv 支持安装的 python 环境
  2. 安装自己想要下载的 python 版本 (可以下载多个)
  3. 查看电脑安装的所有 python 版本
  4. 设置 3.8.0 版本为全局版本,并查看当前设置的全局版本
  5. 查看当前的 python 版本

pyenv 安装遇到问题

在安装 python 版本的时候可能会出现如下几个问题,大家根据自己的情况进行设置即可:

1)安装 python 版本卡在界面不动(或请求超时)。

这种情况一般是由于网络问题,因为安装的 python 是在国外的站点,有三种方式解决:

第一种方式:cmd 走代理,需要科学上网,没有这个条件的朋友直接 pass 看下面方式

第二种方式:手动安装,打开历史版本找到自己要下载的版本号,以 3.8.0-amd64.exe 为例,将其下载完直接拖进 pyenv 的 install_cache 文件夹中,再执行上面的安装命令,即可安装对应的版本

第三种方式 (推荐):找到 pyenv-win 文件夹下的 .versions_cache.xml 文件进行如下操作,更换镜像源的方式可以让我们下载变的更方便:

将 https://www.python.org/ftp/python 全部替换为 https://npm.taobao.org/mirrors/python

2)Win11 系统安装 python 版本之后执行 python -V 没有任何反应(Win10 可能除外)。

这种情况一般是由于 Win11 系统管理应用程序执行别名导致的问题,我们需要点击 win 键输入'管理应用程序执行别名',然后将下面的两个关掉即可。

PyCharm 测试

PyCharm 是书写 py 的编辑器工具,安装教程网上一大堆,都是傻瓜式教程,这里不再赘述,接下来我们通过我们刚才安装好的 python 环境,看看能不能在 PyCharm 中进行跑通!

首先我们要先知道自己通过 pyenv 安装的 python 环境的路径在哪,终端执行如下命令:

pyenv which python

该命令会输出当前激活的 Python 环境的路径。其中 3.8.0 是当前激活的 Python 版本号。如果希望获取其他已安装的 Python 版本的路径,可以将命令中的 python 替换为相应的版本号,该命令会输出版本号为 3.8.7 的 Python 环境的路径。

找到我们安装好的 python 路径之后,接下来我们开始为 PyCharm 配置 python 解释器:

根据之前的路径添加系统解释器,配置好 python 环境,然后点击应用,确定即可。

接下来我们开始编写 hello world 看看代码能跑起来吗?

至此 python 环境的安装已经结束,大家快尝试一下吧。

目录

  1. pyenv-win 简介
  2. pyenv-win 安装
  3. 配置环境变量
  4. pyenv 的基本命令
  5. pyenv 安装 py 环境
  6. pyenv 安装遇到问题
  7. PyCharm 测试

更多推荐文章

查看全部
  • 互联网 HR 招聘实录:张一鸣与业务负责人的用人观
  • 图形管线与渲染引擎中的 C++ 架构设计:模块化、跨平台与资源驱动实践
  • 【verilog语法详解:从入门到精通】
  • 10 款 AI 写小说软件评测与选择指南
  • AI 变现深度拆解:为何掌握大量工具仍无法盈利
  • YOLO+OpenClaw+SAM 微调实战:工业缺陷自动标注方案
  • 从一句话到一张图:看懂 Stable Diffusion 的潜空间扩散生成流程
  • STC32G12K128 指针强转实现 EEPROM 复杂数据类型存储
  • ZeroClaw:零开销全 Rust AI 助手基础设施及与 OpenClaw 对比
  • AI 工作流模板实战:Dify 应用开发与开源 AI 工具落地
  • self-llm 开源大模型部署与微调入门指南
  • GitHub 推送报错?用 SSH 密钥替代密码认证方案
  • LangChain 快速入门:从环境搭建到链式调用实战
  • AI“代笔”的困境与破局:学术查重与 AIGC 检测的理性应对
  • OpenClaw 开源 AI 智能体框架技术架构与实战部署
  • 前端地图开发:标记点(Marker)的添加、删除、拖拽及事件绑定
  • Claude Skill:让大模型生成更具设计感的前端页面
  • 风险投资计划(华为 OD 算法题)
  • 超越代码生成器:深度解析 Triton-Copilot 的人机协同设计哲学
  • C++ 线程库与多线程编程核心机制解析

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online