1. 📚 介绍

1.1. pyenv-win

1.1.1. 简介

pyenv-win 是一个针对 Windows 平台移植的 pyenv 工具。该工具简化了多版本 Python 的管理，方便用户在不同版本之间切换。

1.1.2. 主要特点

• 提供多版本 Python 管理
• 支持通过 pip、PowerShell 和 Chocolatey 安装
• 支持局部（local）、全局（global）和 shell 特定的 Python 版本设置
• 提供多种命令进行版本管理，如安装、卸载、更新等

1.2. pyenv-win-venv

1.2.1. 简介

pyenv-win-venv 是一个用于管理 Python 虚拟环境的命令行界面（CLI）工具。它是 pyenv-win 的一个补充，便于在 Windows 平台上更加高效地管理不同项目的依赖。

1.2.2. 主要特点

• 依赖于 pyenv-win，无需额外配置。
• 提供项目级别的依赖管理，每个项目都有独立的运行环境。
• 命令自动补全功能，提升操作效率。
• 强调安全性，确保操作不影响系统级设置。

2. 💻 安装步骤

Windows 下，安装 pyenv-win 和 pyenv-win-venv

2.1. 安装 pyenv-win

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.2. 安装 pyenv-win-venv

Invoke-WebRequest -UseBasicParsing `
-Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win-venv/main/bin/install-pyenv-win-venv.ps1" `
-OutFile "$HOME\install-pyenv-win-venv.ps1";&"$HOME\install-pyenv-win-venv.ps1"

3. 📚 使用指南

3.1. 利用 pyenv-win 切换 Python 版本

列出可用的 Python 版本

pyenv install --list

安装指定版本

pyenv install 3.9.1

设置全局 Python 版本

pyenv global 3.9.1

设置当前目录下的 Python 版本

pyenv local 3.8.5

3.2. 利用 pyenv-win-venv 创建虚拟环境

创建一个新的虚拟环境

pyenv-venv install 3.9.1 env_name

3.3. 管理虚拟环境

列出所有已安装的虚拟环境

pyenv-venv list envs

移除一个已经存在的虚拟环境

pyenv-venv uninstall env_name

激活虚拟环境

pyenv-venv activate env_name

停用当前激活的虚拟环境

pyenv-venv deactivate

4. 🎉 实战示例

4.1. 创建一个 Flask 项目并配置不同 Python 版本

在当前目录下创建一个新的 Flask 项目

mkdir my_flask_app
cd my_flask_app

设置该项目使用的 Python 版本

pyenv local 3.9.1

创建并激活虚拟环境

pyenv-venv install 3.9.1 flask-env
pyenv-venv activate flask-env

安装 Flask

pip install Flask