PROVIDER - Python 依赖与打包一体化

Poetry

Poetry 用 1 份 pyproject.toml 统一管理 Python 依赖、虚拟环境与打包发布,poetry.lock 锁定全部传递依赖,并支持 dev、test 等多组依赖按需安装;其代价是严格解析策略与较慢的大依赖树求解速度。

开发工具 美国 2026.11.19
4.3分

详细说明

优势 5 项

用 1 份 pyproject.toml 同时管理依赖声明、元数据与打包配置
生成 1 份 poetry.lock 锁文件,固定全部传递依赖的版本与哈希
内置虚拟环境管理,1 条命令即可创建与切换环境,无需额外 virtualenv 工具
支持依赖分组,dev、test、docs 等 3 类以上依赖可按需安装
1 条命令完成构建与发布,可推送至 PyPI 或私有仓库

不足 4 项

解析算法较严格,部分历史项目的宽松版本约束会解析失败
与 pip、requirements.txt 工作流并存时需要额外同步
大型依赖树的解析耗时明显高于 uv 等新一代工具
插件体系相对薄弱,扩展能力有限

服务商概述

Poetry 是 Python 生态中流行的依赖管理与打包工具。它把依赖声明、项目元数据、虚拟环境与构建发布整合进一份 pyproject.toml,并用锁文件保证团队安装结果一致。

在开发工具分类里,它属于「语言级包管理」:与 pip 只负责安装不同,Poetry 覆盖从依赖解析到发布 PyPI 的完整链路。

核心优势

  • 配置统一:1 份 pyproject.toml 承载依赖、元数据与构建配置
  • 锁定可靠:poetry.lock 固定所有传递依赖的版本与哈希
  • 环境内置:自带虚拟环境创建与切换能力
  • 依赖分组:dev、test、docs 多组依赖按需安装
  • 发布顺畅:单条命令构建并上传至 PyPI 或私有源

产品生态

平台能力

依赖解析、锁文件管理、虚拟环境操作、脚本命令定义、构建 wheel 与 sdist、私有源配置。

集成

可与 GitHub Actions、pre-commit、tox、Docker 多阶段构建以及 PyPI、Artifactory 等制品源配合。

典型场景

Python 库与应用开发、团队依赖一致化、内部包发布、CI 中的可复现安装。

不足之处

  • 解析严格:宽松的历史版本约束可能无法求解
  • 工作流割裂:与 pip、requirements.txt 并存时需要额外同步
  • 性能一般:大型依赖树求解慢于新一代工具
  • 插件有限:扩展生态不如部分同类工具活跃

适用场景

  • Python 库开发(★★★★★):打包与发布链路一体化
  • 团队依赖一致化(★★★★★):锁文件保证环境统一
  • 多环境依赖分离(★★★★☆):依赖分组减少安装体积
  • 超大规模单体仓库(★★★☆☆):可考虑更快的解析工具

价格参考

项目 价格 备注
Poetry 本体 $0 MIT 开源,可商用
PyPI 托管 $0 公共包免费发布
私有仓库 视服务而定 Artifactory、CodeArtifact 等按用量计费

常见问题

Poetry 与 pip 的关系是什么?

Poetry 负责解析与锁定依赖,内部仍可用 pip 生态的包;两者可共存,但应避免同时修改依赖。

需要手动创建虚拟环境吗?

不需要,poetry install 会自动创建并复用项目虚拟环境。

可以把锁文件纳入版本控制吗?

应该纳入。锁文件是团队与 CI 环境一致性的基础。

与 uv 相比如何?

uv 解析与安装速度更快;Poetry 在打包发布与生态成熟度上更稳定。

代码示例

# pyproject.toml
[tool.poetry]
name = "demo-service"
version = "0.1.0"
description = "Demo service"
authors = ["Dev Team <[email protected]>"]

[tool.poetry.dependencies]
python = "^3.11"
fastapi = "^0.110.0"

[tool.poetry.group.dev.dependencies]
pytest = "^8.0"
ruff = "^0.3"

[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"
# 安装依赖并锁定
poetry install

# 新增开发依赖
poetry add --group dev pytest

# 构建并发布
poetry build
poetry publish

社区与资源

  • 官方网站:https://python-poetry.org/
  • 源码仓库:https://github.com/python-poetry/poetry
  • 官方文档:https://python-poetry.org/docs/
前往 Poetry 官网 → https://python-poetry.org/
访问官网 ↗