pyenv-virtualenv（python 版本管理工具）

推荐参考（本人实测有用）

参考文章@pyenv 和 pyenv-virtualenv 的安装、配置和使用（仅供参考）

参考文章 @pyenv+pyenv-virtualenv（仅供参考）

pyenv (windows)安装

1. 手动安装

git clone https://github.com/pyenv-win/pyenv-win.git "$HOME.pyenv"

"$HOME.pyenv" 表示将仓库克隆到 c盘文件下

• 如果不想放置在c盘，可不带该段指令

2. 配置环境变量

将下面路径添加到 系统环境变量 的 path 中

%USERPROFILE%\.pyenv\pyenv-win\bin
%USERPROFILE%\.pyenv\pyenv-win\shims

3. 重启终端或执行

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")

4. 验证安装

pyenv --version  # 应输出 pyenv-win 版本号，如 "pyenv 2.64.11"

pyenv 可用命令

1. 查看可安装版本

pyenv install --list

2. 安装指令版本

pyenv install 3.9.5

3. 解决安装问题

网络问题：使用镜像源加速下载

pyenv install 3.9.5 --mirror https://npm.taobao.org/mirrors/python/

手动安装：

• 从 python 官网下载对应版本的 .zip 文件
• 将文件放入 ~.pyenv\pyenv-win\install_cache
• pyenv install 3.9.5

管理python 版本

1. 查看已安装版本

pyenv versions  # 带 * 的为当前激活版本

2. 设置全局默认版本

pyenv global 3.9.5  # 全局生效（所有目录）

3. 设置局部版本（当前目录）

pyenv local 3.9.5  # 生成 `.python-version` 文件

4. 临时切换版本（仅当前会话）

pyenv shell 3.9.5

5. 验证当前 Python 路径

pyenv which python  # 应返回 pyenv 安装的路径，如 `~\.pyenv\pyenv-win\versions\3.9.5\python.exe`

常用操作

1. 更新 pyenv-win

pyenv update  # 通过 Chocolatey 安装的需用 `choco upgrade pyenv-win`

2. 卸载 Python 版本

pyenv uninstall 3.9.5

3. 理缓存和版本

pyenv rehash  # 安装新版本或工具后执行

虚拟环境管理

1. 使用 pyenv-virtualenv 插件

• 安装插件：

git clone https://github.com/pyenv-win/pyenv-virtualenv.git "$HOME\.pyenv\plugins\pyenv-virtualenv"

• 创建虚拟环境：

pyenv virtualenv 3.9.5 myenv  # 基于 Python 3.9.5 创建虚拟环境 `myenv`

• 激活/停用虚拟环境：

pyenv activate myenv    # 激活
pyenv deactivate        # 停用