基于 pyenv-win 和 Poetry 构建 Python 开发环境

2024-02-08 2024-04-12 1203 字 3 分钟

简介

构建和维护一个高效、可靠的 Python 开发环境是至关重要的。为了实现这一目标，开发者可以选择多种工具来搭建自己的开发环境，包括但不限于 virtualenv、venv、conda、pipenv、poetry 以及 pyenv。每种工具都有其独特的特点和优势，但本文档将重点介绍在 Windows 系统下，如何利用 pyenv-win 和 Poetry 这两个强大的工具来构建一个现代化的 Python 开发环境。

pyenv-win 是 pyenv（一个流行的多版本 Python 管理工具）的 Windows 版本。它提供了一个简单而强大的解决方案，使开发者能够在同一个系统中安装、管理，并轻松切换多个 Python 版本。这一功能尤其对于同时进行多个项目，且每个项目需要不同 Python 版本的开发者来说，是极其有用的。pyenv-win 的引入，极大地简化了在 Windows 系统上管理多个 Python 版本的复杂度，从而使开发者能够专注于编码和项目构建，而非环境配置。

Poetry是一个 Python 依赖管理和打包工具。 Poetry 使用 pyproject.toml 文件来定义项目的依赖和配置，该方法提供了比传统 setup.py 文件更清晰、更直观的依赖声明方式。此外，Poetry 自带的依赖解析器能够自动解决依赖冲突，确保项目依赖的一致性和项目的可重复构建。

安装指南

前提条件

Windows 7 或更高版本。
PowerShell 5 或更高版本（推荐使用 PowerShell 7）。
git。

安装 pyenv-win

打开 PowerShell：以管理员身份运行 PowerShell。
安装 pyenv-win：使用 git 克隆 pyenv-win 到 ‘~/.pyenv’ 目录。
```
git clone https://github.com/pyenv-win/pyenv-win.git "$HOME/.pyenv"
```

配置环境变量：在 PowerShell 中运行以下命令，添加 pyenv 相关的环境变量。

[System.Environment]::SetEnvironmentVariable('PYENV', "$HOME/.pyenv/pyenv-win/", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('Path', "$env:Path;$HOME/.pyenv/pyenv-win/bin;$HOME/.pyenv/pyenv-win/shims", [System.EnvironmentVariableTarget]::User)

重启 PowerShell：关闭并重新打开 PowerShell 以应用更改。
验证安装：运行以下命令，如果安装成功，将显示 pyenv 版本。
```
pyenv --version
```

Note: 由于网络原因，建议设置PYTHON_BUILD_MIRROR_URL为镜像站点，如https://mirrors.huaweicloud.com/python/。也可以设置PYTHON_BUILD_ARIA2_OPTS为建议值：-x 10 -k 1M。在设置该值前，请确保安装了aria2。

安装 Poetry

打开 PowerShell：不需要以管理员身份运行。

运行安装脚本：使用 Poetry 官方提供的安装命令。

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -

配置环境变量（如果安装脚本未自动完成）：确保 Poetry 的安装路径添加到您的环境变量中。通常，Poetry 会被安装在 C:\Users\用户名\AppData\Roaming\Python\Scripts 或 C:\Users\用户名\.poetry\bin。
验证安装：重新打开 PowerShell 并运行以下命令来验证 Poetry 安装成功：
```
poetry --version
```

使用 pyenv-win 管理 Python 版本

列出可用的 Python 版本
```
pyenv install --list
```
安装特定版本的 Python
```
pyenv install 3.8.10
```
设置全局 Python 版本
```
pyenv global 3.8.10
```

可以试着设置系统的环境变量，以此加速安装过程：PYTHON_BUILD_MIRROR_URL="https://mirrors.huaweicloud.com/python/"

使用 Poetry 管理项目依赖

创建新项目
```
poetry new my_project
```
添加依赖
```
cd my_project
poetry add requests
```
安装依赖
```
poetry install
```