pyenv-win | python版本管理，无需卸载当前版本

### 一、安装和配置 pyenv-win #### 1. 克隆 pyenv-win 仓库 在 Windows 11 系统上，可以通过 PowerShell 或者 Git Bash 执行以下命令来克隆 `pyenv-win` 到本地： ```powershell git clone https://github.com/pyenv-win/pyenv-win.git "$HOME\.pyenv" ``` 此命令会将 `pyenv-win` 存储库下载到用户的主目录下的 `.pyenv` 文件夹中[^1]。 --- #### 2. 配置环境变量 为了使系统能够识别 `pyenv` 命令，需要将 `pyenv` 的路径添加到系统的环境变量 `PATH` 中。具体步骤如下： - **打开环境变量设置窗口**：右键单击“此电脑”，选择“属性” -> “高级系统设置” -> “环境变量”。 - **编辑 PATH 变量**：找到用户变量或系统变量中的 `Path`，点击“编辑”。然后添加以下两个路径： - `%USERPROFILE%\.pyenv\bin` - `%USERPROFILE%\.pyenv\shims` 完成以上操作后，重新启动终端（PowerShell 或 Git Bash），以确保更改生效[^1]。 --- #### 3. 验证安装 验证 `pyenv` 是否正确安装并配置好，可以在终端中运行以下命令： ```powershell pyenv --version ``` 如果返回了版本号，则说明安装成功[^4]。 --- ### 二、使用 pyenv-win 管理 Python 版本 #### 1. 查看可用的 Python 版本 要查看所有可以安装的 Python 版本列表，可以运行以下命令： ```powershell pyenv install --list ``` 或者仅显示部分版本（例如包含 `3.x` 的版本）： ```powershell pyenv install --list | findstr 3. ``` --- #### 2. 安装特定版本的 Python 假设需要安装 Python 3.9.7，可以运行以下命令： ```powershell pyenv install 3.9.7 ``` 也可以一次性安装多个版本： ```powershell pyenv install 3.8.10 3.9.7 ``` --- #### 3. 卸载特定版本的 Python 如果不再需要某个版本的 Python，可以将其卸载。例如卸载 Python 3.9.7： ```powershell pyenv uninstall 3.9.7 ``` --- #### 4. 查看已安装的 Python 版本 要查看当前系统中已经安装的所有 Python 版本，可以运行以下命令： ```powershell pyenv versions ``` 其中带星号 (`*`) 的表示当前正在使用的版本。 --- #### 5. 设置全局或局部的 Python 版本 - **设置全局默认版本**： ```powershell pyenv global 3.9.7 ``` - **设置某文件夹内的局部版本**： 进入目标文件夹后执行以下命令： ```powershell pyenv local 3.9.7 ``` 此时会在该文件夹下生成一个名为 `.python-version` 的隐藏文件，记录所选的 Python 版本。 --- #### 6. 更新 pyenv 自身 如果有新版本发布，可以更新 `pyenv` 工具本身： ```powershell cd $HOME\.pyenv git pull origin master ``` --- ### 三、注意事项 - 如果通过 `pip` 安装新的包或其他方式修改了 Python 版本对应的可执行文件，建议运行以下命令刷新缓存： ```powershell pyenv rehash ``` - 在某些情况下，可能需要管理员权限才能顺利完成安装或卸载操作。 ---