Poetry 是一个用于 Python 项目依赖管理和打包的现代化工具。它旨在简化 Python 项目的创建、依赖管理以及打包发布流程，为开发者提供一致且高效的工作流。本文将详细介绍 Poetry 的核心功能、优势以及基本使用方法。

什么是 Poetry？

Poetry 是一个开源的 Python 工具，由 Sébastien Eustace 开发，并于 2018 年首次发布。它结合了 pip 和 virtualenv 的功能，同时提供了更直观的依赖管理和项目打包支持。Poetry 的核心目标是解决 Python 生态中依赖管理的常见问题，例如版本冲突和重复依赖。

Poetry 的核心功能

  1. 依赖管理：
    Poetry 使用 pyproject.toml 文件来声明项目依赖，支持精确的版本控制，并自动解析依赖冲突。

  2. 虚拟环境管理：
    Poetry 可以自动创建和管理虚拟环境，确保项目依赖的隔离性。

  3. 打包与发布：
    Poetry 支持将项目打包为 Wheel 或源码分发包，并可以直接发布到 PyPI 或其他私有仓库。

  4. 脚本支持：
    开发者可以通过 Poetry 定义和运行项目脚本，简化开发流程。

为什么选择 Poetry？

与传统的 Python 依赖管理工具（如 pip + requirements.txt）相比，Poetry 提供了以下优势：

  1. 更清晰的依赖声明：
    pyproject.toml 文件结构清晰，支持分组依赖（如开发依赖和生产依赖）。

  2. 自动解决依赖冲突：
    Poetry 使用 SAT 求解器解析依赖关系，避免版本冲突。

  3. 一体化工具链：
    无需单独配置 pip、virtualenv 或 setuptools，Poetry 集成了所有功能。

  4. 更好的可重复性：
    Poetry 生成 poetry.lock 文件锁定依赖版本，确保跨环境的一致性。

如何安装 Poetry？

Poetry 可以通过以下命令安装：

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

安装完成后，可以通过以下命令验证是否安装成功：

poetry --version

基本使用方法

1. 创建新项目

使用 Poetry 创建一个新项目：

poetry new my-project

这将生成一个标准的 Python 项目结构，包括 pyproject.toml 文件。

2. 添加依赖

通过以下命令添加依赖：

poetry add requests

如果需要添加开发依赖（如测试工具），可以使用 --group dev 参数：

poetry add pytest --group dev

3. 运行项目

在虚拟环境中运行脚本：

poetry run python my_script.py

4. 打包与发布

打包项目：

poetry build

发布到 PyPI：

poetry publish

总结

Poetry 是一个强大的 Python 依赖管理工具，能够显著提升开发效率和项目的可维护性。通过清晰的依赖声明、自动化的虚拟环境管理以及一体化的打包发布功能，Poetry 已经成为现代 Python 开发者的首选工具之一。如果你还未尝试过 Poetry，不妨从一个小项目开始体验它的便利性！

延伸阅读：