Poetry

Poetry 是一个 Python 语言的依赖管理与打包工具，旨在简化 Python 项目的依赖管理、构建和发布流程。它基于 PEP 518 和 PEP 621 标准，使用 pyproject.toml 文件统一管理项目元数据和依赖关系，提供版本锁文件（poetry.lock）确保环境可重现。

核心功能

• 依赖管理与解析：通过 poetry add 命令添加依赖，内置强大的依赖解析器，自动解决版本冲突并生成锁文件，保证跨环境一致性。
• 虚拟环境隔离：自动为每个项目创建独立虚拟环境（也可配置使用已有环境），避免依赖冲突，支持 Python 版本管理。
• 打包与构建：使用 poetry build 可一键构建源代码分发包（sdist）和 Wheel 包，支持配置包含/排除文件。
• 发布到 PyPI：通过 poetry publish 命令将包发布到 PyPI 或私有仓库，支持认证和上传。
• 依赖树查看：poetry show --tree 展示依赖层级关系，poetry show --latest 检查更新。

适用人群

• Python 库或应用开发者，希望规范化项目依赖和版本。
• 团队协作场景，需要锁定依赖版本以保证环境一致。
• 需要发布包到 PyPI 或私有仓库的开发者。

使用方式

1. 安装 Poetry（推荐使用官方安装脚本 curl -sSL https://install.python-poetry.org | python3 -）。
2. 在项目根目录执行 poetry init 初始化 pyproject.toml，或直接 poetry new 创建新项目模板。
3. 使用 poetry add package_name 添加依赖，poetry install 安装全部依赖。
4. 运行 poetry run your_command 在项目环境中执行脚本，或 poetry shell 激活虚拟环境。

注意事项

• Poetry 要求项目遵守 PEP 440 版本规范，不支持非标准版本号（如 1.0.0-hotfix.1）。
• 依赖解析可能较慢，尤其在涉及大量无元数据包时；可考虑使用缓存或明确声明版本约束优化。
• Poetry 2.0 推荐使用 [project] 表而非 [tool.poetry] 表声明依赖，需注意兼容性。
• 插件系统允许扩展功能，但需谨慎选择社区插件。