Python -- pyenv-windows 管理多 Python 版本

前言：

pyenv-windows 可以在 Windows 上高效管理多版本 Python 环境，方便更换版本。

安装：

1、下载 pyenv-windows

使用 Git 克隆 pyenv-win 到正确目录

git clone https://github.com/pyenv-win/pyenv-win.git ~/.pyenv

• 从 GitHub 克隆 pyenv-win 代码
• 存放到你的用户目录下的 .pyenv 文件夹（即 C:\Users\你的用户名\.pyenv）

2、配置环境变量

右键“此电脑” → “属性” → “高级系统设置” → “环境变量”

在 用户变量 中添加：

变量名	值
PYENV	C:\Users\你的用户名\.pyenv\pyenv-win
PYENV_ROOT	%PYENV%
PYENV_HOME	%PYENV%

修改 用户变量中的 Path，添加：

%PYENV%\bin
%PYENV%\shims

3、验证是否安装成功

pyenv --version

使用：

0、设置环境变量

1、临时：

set PYTHON_BUILD_MIRROR_URL=https://mirrors.tuna.tsinghua.edu.cn/pyenv/
pyenv install 版本号

2、永久：

操作步骤：

1. 打开 控制面板 → 系统和安全 → 系统 → 高级系统设置
2. 点击 环境变量（Environment Variables）
3. 在 用户变量 或 系统变量 中点击 新建（New）
4. 输入：
   • 变量名：PYTHON_BUILD_MIRROR_URL
   • 变量值：https://mirrors.tuna.tsinghua.edu.cn/pyenv/
5. 点击确定，保存。

1、查看可安装的python版本

# 列出所有可用版本
pyenv install --list

# 搜索特定版本（如 3.9）
pyenv install --list | grep "3.9"
pyenv install --list | findstr "3.9"

2、安装指定版本的 Python

pyenv install 3.9.19

安装过程会自动下载源码、编译并安装到 ~/.pyenv/versions/ 目录下。

3、验证是否安装成功

pyenv versions

查看已安装的所有 Python 版本

4、设置全局默认版本

①、全局Python版本

pyenv global 3.9.19

这样会设置你整个系统的默认 Python 版本

②、局部Python版本

# 进入项目目录
cd myproject
pyenv local 3.12.4

这会在项目根目录生成一个 .python-version 文件，下次进入自动切换。

③、临时Python版本

pyenv shell 3.9.19

仅当前shell终端会话有效，关闭后失效。

5、卸载多余的Python版本

pyenv uninstall 3.9.19