Poetry：面向 Python 的依赖管理与打包工具

获取下载链全程约 1 分钟

1. 打开微信，搜索「软件教程管家」关注，或长按下方二维码关注
2. 回复关键词 Poetry 复制关键词
3. 公众号自动回复网盘链接，点击即可保存下载

打开微信扫一扫关注
或搜索【软件教程管家】

官方渠道：GitHub 仓库

Poetry 是面向 Python 项目的依赖管理与打包工具，以 pyproject.toml 统一项目配置，帮助声明、解析和安装依赖，并支持通过插件导出或部署项目。一个配置文件管依赖、管打包、管环境，是 Poetry 最核心的卖点。

获取 Poetry

前往 GitHub 查看源码

GitHub 国内访问较慢，如打不开可多刷新几次

快速判断

如果团队希望用单一的 pyproject.toml 工作流统一 Python 依赖管理、项目打包和环境安装，Poetry 值得纳入候选。若现有流程高度依赖 requirements.txt、传统 setup.py 或特定构建工具，应先验证迁移成本、插件需求和 CI 兼容性，再决定是否全面采用。

核心功能

• 使用基于 pyproject.toml 的项目格式管理 Python 项目配置，依赖、元数据与构建配置集中在一处。
• 声明、管理和安装项目依赖，并在不同环境中保持一致的依赖栈，锁定文件保证可复现。
• 可替代 setup.py、requirements.txt、setup.cfg、MANIFEST.in 和 Pipfile 的组合式配置方式，减少配置文件数量。
• 关联 poetry-core，为 Poetry 项目提供 PEP 517 构建系统和核心功能。
• poetry-plugin-export 可将 Poetry 项目或锁定文件导出为 requirements.txt 等外部格式，方便与既有工具链对接。

工作机制

Poetry 是以 Python 编写的项目依赖管理与打包工具，围绕基于 pyproject.toml 的项目格式工作，用于声明、解析和安装依赖，并通过 poetry-core 提供 PEP 517 构建相关能力。依赖解析结果写入锁定文件，团队成员与 CI 用同一份锁定文件安装，环境差异大幅减少。

上手步骤

Linux / macOS 用官方安装脚本：

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

Windows 用 PowerShell 执行官方安装命令（见项目安装文档），也可以用 pipx 安装。装好后按以下步骤完成初次使用：

1. 新建项目：执行 poetry new my-project，生成带 pyproject.toml 的项目骨架。
2. 添加依赖：执行 poetry add requests，Poetry 会解析版本并更新锁定文件。
3. 安装环境：执行 poetry install，按锁定文件装好与团队一致的依赖栈。
4. 运行命令：用 poetry run python main.py 在项目环境中执行代码，确认环境隔离生效。

版本与部署方式选择

• 新项目：直接用 Poetry 管理，从一开始就统一配置格式，避免后期迁移。
• 已有项目迁移：先用 poetry-plugin-export 导出 requirements.txt 做过渡验证，确认依赖解析结果与现有环境一致后再切换。
• 持续集成：CI 中固定 Poetry 版本与 Python 版本，并缓存依赖安装结果，避免每次构建都重新解析。

上手后建议确认的几项配置

• 锁定文件进版本控制：把 pyproject.toml 与 poetry.lock 一起提交，锁定文件是可复现环境的保证，只提交前者等于放弃了一半收益。
• 虚拟环境位置：按团队习惯决定，执行 poetry config virtualenvs.in-project true 可把环境建在项目目录内，方便排查与清理。
• 私有包仓库：需要时用 poetry source add 配置，不要把私仓地址写进会公开的配置文件。
• 发布流程：发布前用 poetry build 检查构建产物，用 poetry check 校验配置，发现问题先修再发。

注意事项

• 现有项目从多种配置文件迁移到 pyproject.toml 时，仍需结合项目结构和构建流程进行验证，不要假设一次迁移就能完全对齐。
• README 摘要未完整列出操作系统、Python 兼容范围和全部 CI 配置要求，具体版本以对应版本的安装文档为准。
• 插件属于关联项目，具体功能、兼容性和维护边界需分别查看各插件的 README 或源码。
• 公开摘要未说明私有包仓库、复杂发布流程或特殊构建场景的完整配置方式，使用前需进行针对性验证。

适合人群与同类对比

适合需要统一管理 Python 项目依赖、项目元数据和打包流程的个人开发者、团队与持续集成维护者，尤其适合从零开始、希望一套配置走到底的新项目。

与 pip + venv 手工组合相比，Poetry 把依赖声明、锁定、环境与打包收进同一套流程，不用再维护 requirements.txt、setup.py 等多个文件；与 Pipenv 相比，Poetry 采用 pyproject.toml 标准格式，与 PEP 517 构建体系直接对接，配置文件更通用。取舍的关键在团队现状：新项目用 Poetry 收益明确，已有项目则要先算迁移成本，流程越重越要先试点。

选型建议

优先选择 Poetry 的场景是项目希望集中管理依赖声明、项目元数据和打包配置，并接受以 pyproject.toml 为核心的工作流。如果必须直接维护多种外部依赖格式、依赖特殊构建后端或需要未在摘要中说明的仓库集成，应先查看完整文档和源码并制作迁移验证，小范围试点通过后再推广。

推广

关注「软件教程管家」

回复软件名即取即下：网盘下载链接 + 提取码，一步直达，不用再跳转。

相关推荐

开发KubeVirt：面向 Kubernetes 的虚拟机管理扩展开发FuseSoC：面向 FPGA 与 ASIC 的 HDL 包管理和构建工具开发Quadruped-PyMPC：面向四足机器人的 Python 模型预测控制器开发Gerrit：面向 Git 项目的代码评审与项目管理工具开发Requests：面向 Python 的简洁 HTTP/1.1 客户端库系统工具NVIDIA App 11.0.9.251中文版下载 | NVIDIA显卡驱动管理与游戏优化工具