Ubuntu 24.04 安装 Poetry：Python 依赖管理的终极指南

在 Python 开发中，依赖管理是一个非常重要的环节。Poetry 是一个现代化的 Python 依赖管理工具，它不仅可以帮助我们管理项目的依赖，还可以管理虚拟环境、打包和发布项目。本文将详细介绍如何在 Ubuntu 24.04 上安装和配置 Poetry，并展示如何使用它来管理 Python 项目。

---

1. 更新系统包列表

在安装 Poetry 之前，首先确保系统包列表是最新的：

sudo apt update

---

2. 安装 Poetry

Poetry 可以通过多种方式安装，以下是两种推荐的方法：

方法 1：使用官方安装脚本

这是官方推荐的方式，适用于大多数用户：

curl -sSL https://install.python-poetry.org | python3 -

安装完成后，Poetry 会被安装到 ~/.local/bin 目录下。

方法 2：使用 Pipx 安装

Pipx 是一个用于隔离安装 Python 应用的工具，推荐使用：

sudo apt install pipx -y
pipx ensurepath
pipx install poetry

这种方式可以避免 Poetry 的依赖与系统全局 Python 环境冲突。

---

3. 配置环境变量

如果使用官方安装脚本，需要将 Poetry 的可执行文件路径添加到环境变量中：

export PATH="$HOME/.local/bin:$PATH"

将上述命令添加到 ~/.bashrc 或 ~/.zshrc 文件中，然后运行以下命令使其生效：

source ~/.bashrc

---

4. 验证安装

安装完成后，检查 Poetry 是否安装成功：

poetry --version

如果显示 Poetry 的版本号（如 Poetry (version 2.0.0)），说明安装成功。

---

5. 配置 Poetry（可选）

设置虚拟环境位置

默认情况下，Poetry 会将虚拟环境存储在 ~/.cache/pypoetry/virtualenvs 目录下。你可以将其修改为项目目录内：

poetry config virtualenvs.in-project true

配置镜像源

如果需要加速依赖包的下载，可以为 Poetry 配置国内镜像源（如清华源）：

poetry source add --priority=supplemental tuna https://pypi.tuna.tsinghua.edu.cn/simple

---

6. 创建和管理项目

创建新项目

使用 Poetry 创建一个新项目：

poetry new my-project

这将生成一个包含 pyproject.toml 文件的项目结构。

安装依赖

进入项目目录并安装依赖：

cd my-project
poetry install

添加依赖

添加新的依赖包：

poetry add requests

激活虚拟环境

进入 Poetry 管理的虚拟环境：

poetry shell

---

7. 卸载 Poetry（可选）

如果需要卸载 Poetry，可以使用以下命令：

curl -sSL https://install.python-poetry.org | python3 - --uninstall

或者，如果通过 Pipx 安装：

pipx uninstall poetry

---

总结

通过以上步骤，你可以在 Ubuntu 24.04 上成功安装并配置 Poetry，用于 Python 项目的依赖管理和虚拟环境管理。Poetry 不仅简化了依赖管理的过程，还提供了强大的功能来管理项目的整个生命周期。如果你还没有尝试过 Poetry，现在就是一个好时机！

如果需要更详细的功能说明，可以参考 Poetry 官方文档。