poetry打包安装

使用 Poetry 进行 Python 项目打包、安装和发布的终极实战指南

1. 前言

在 Python 后端开发过程中，依赖管理和包分发是不可或缺的环节。Poetry 是一个集依赖管理、虚拟环境管理、构建与发布于一体的工具，可帮助你更加优雅、高效地管理你的 Python 项目。本指南将从基础配置、依赖管理，到构建和发布（包括与 Wheel 包的整合）为你提供一整套详细的实战手册。

在阅读本教程时，假设你已经具备以下条件和环境准备：

• 具备 Python 基础知识和后端项目结构概念。
• 本机已安装 Python 3.7+ 版本。
• 已可以在命令行运行基本 Python 与 shell 命令。

---

2. 为什么选择 Poetry

在传统的 Python 项目中，人们常用 requirements.txt 来维护依赖，用 setup.py 或 setup.cfg/MANIFEST.in 来完成打包与发布。然而，这些传统方法中存在以下问题：

• 依赖管理复杂：开发者需要手动维护 requirements.txt，可能无法确保开发环境与生产环境中依赖的一致性。
• 发布过程冗长：需要分别借助 setuptools、twine、wheel 等工具手工打包、上传。
• 缺少统一、直观的配置文件：信息分散在多个文件中，不易追踪和维护。

Poetry 通过统一的 pyproject.toml 文件将依赖管理和项目元数据整合在一起，并自动生成 poetry.lock 文件确保依赖版本一致性。此外，Poetry 内置了对虚拟环境和构建打包的支持，并可直接发布到 PyPI 或其他私有仓库。这大大简化了开发与运维流程。

---

3. 环境安装与基础配置

3.1 安装 Poetry

官方推荐的安装方式（在 Linux/macOS/Windows 上均适用）为使用 install-poetry.py 脚本：

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

安装完成后，你需要将 Poetry 的可执行文件目录添加到系统 PATH 中（如 Linux/macOS 在 ~/.bashrc 或 ~/.zshrc 中添加）：

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

Windows 用户可在系统环境变量中添加相应路径。
最后运行以下命令确认安装是否成功：

poetry --version

若正常显示版本号，则表示安装完成。