python中Poetry包管理工具详解

更新时间：2025年11月02日 10:41:29 作者：言之。

Poetry是Python的现代化一站式工具,整合了依赖管理、虚拟环境管理和打包发布功能,相比传统 pip+virtualenv,它通过声明式配置和锁文件解决依赖混乱问题,感兴趣的可以了解一下

二、Poetry 的核心特性

功能	说明
📦 统一依赖管理	通过 `pyproject.toml` 声明依赖，自动生成锁文件 `poetry.lock`，确保依赖可重现性。
🧩 自动虚拟环境	自动创建并管理独立的虚拟环境，无需手动 `venv` 或 `virtualenv`。
🚀 项目构建与发布	一条命令即可构建并发布到 PyPI 或私有仓库。
🔐 精确锁定版本	使用 `poetry.lock` 精确记录依赖的版本与来源，避免“works on my machine”。
🔧 声明式配置	使用 `pyproject.toml`（PEP 518/621 标准）统一项目元数据与依赖信息。

三、Poetry vs pip + virtualenv

对比项	pip + virtualenv	Poetry
依赖声明	`requirements.txt`	`pyproject.toml`
依赖锁定	手动	自动生成 `poetry.lock`
虚拟环境	需手动创建与激活	自动创建与管理
构建发布	需编写 `setup.py`	`poetry build` + `poetry publish`
版本冲突处理	手动调试	内置版本解析器自动解决
可重现环境	弱	强（依赖锁定）

四、Poetry 安装

推荐使用官方安装脚本：

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

安装后可检查版本：

poetry --version

安装路径通常位于 ~/.local/bin/poetry（Linux/Mac）或 %APPDATA%\pypoetry（Windows）。

五、Poetry 项目结构

创建新项目：

poetry new myproject

生成的目录结构如下：

myproject/
├── pyproject.toml        # 项目配置文件
├── poetry.lock           # 依赖锁定文件（首次 install 后生成）
├── myproject/            # 包代码
│   └── __init__.py
└── tests/                # 测试代码

六、依赖管理命令

1. 添加依赖

poetry add requests

添加开发依赖：

poetry add --dev pytest black

自动更新 pyproject.toml 和 poetry.lock。

2. 安装依赖

poetry install

安装指定环境下的依赖（例如生产）：

poetry install --without dev

3. 移除依赖

poetry remove requests

4. 更新依赖

poetry update

5. 查看依赖树

poetry show --tree

七、虚拟环境管理

Poetry 自动为每个项目创建独立虚拟环境。
常用命令如下：

命令	说明
poetry env list	列出虚拟环境
poetry env info	显示当前虚拟环境信息
poetry shell	激活虚拟环境
poetry run python	在虚拟环境中执行命令（不进入 shell）

例如：

poetry run pytest

八、构建与发布

构建包

poetry build

生成：

dist/
├── myproject-0.1.0.tar.gz
└── myproject-0.1.0-py3-none-any.whl

发布到 PyPI

poetry publish --build --username <user> --password <pass>

或使用 token：

poetry config pypi-token.pypi <your-token>
poetry publish --build

九、配置文件详解：pyproject.toml

示例：

[tool.poetry]
name = "myproject"
version = "0.1.0"
description = "A simple example project"
authors = ["Alice <alice@example.com>"]
readme = "README.md"
license = "MIT"

[tool.poetry.dependencies]
python = "^3.9"
requests = "^2.31"

[tool.poetry.group.dev.dependencies]
pytest = "^8.0"
black = "^24.0"

[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"

十、Poetry 常用工作流示例

# 初始化项目
poetry init

# 添加依赖
poetry add fastapi uvicorn

# 激活环境
poetry shell

# 启动服务
poetry run uvicorn app.main:app --reload

# 生成锁文件并安装依赖
poetry install

# 构建并发布包
poetry build && poetry publish

十一、与其他工具集成

✅ 支持 PyCharm / VS Code 自动识别 Poetry 虚拟环境；
✅ 可与 Docker 集成（可直接复制 .venv 或使用 poetry export 导出 requirements.txt）；
✅ 支持 多环境依赖管理（dev/test/prod）。

十二、实用技巧

场景	命令
导出为 requirements.txt	poetry export -f requirements.txt --output requirements.txt
强制重新创建虚拟环境	poetry env remove python && poetry install
仅更新某个包	poetry update requests
检查安全漏洞	poetry check

✅ 总结

优点	缺点
统一依赖、环境、构建管理	首次学习曲线略高
更安全的依赖锁定机制	与某些旧版工具兼容性差
简化包发布流程	CI/CD 集成需额外配置
自动虚拟环境、可重现性强	需适应新语法（pyproject.toml）

到此这篇关于python中Poetry包管理工具详解的文章就介绍到这了,更多相关python Poetry包内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

详解Python对某地区二手房房价数据分析
这篇文章主要为大家介绍了Python数据分析某地区二手房房价，具有一定的参考价值，感兴趣的小伙伴们可以参考一下，希望能够给你带来帮助
2021-12-12
Python绘制百分比堆叠柱状图并填充图案
这篇文章主要为大家详细介绍了Python绘制百分比堆叠柱状图并填充图案，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-04-04
Python input输入超时选择默认值自动跳过问题
这篇文章主要介绍了Python input输入超时选择默认值自动跳过问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-02-02
简述python Scrapy框架
这篇文章主要介绍了python Scrapy框架的相关资料，帮助大家开始学习python 爬虫，感兴趣的朋友可以了解下
2020-08-08
python开发利器之ulipad的使用实践
Ulipad是一个国人limodou编写的专业Python编辑器，它基于wxpython开发的GUI(图形化界面)。下面这篇文章主要介绍了python开发利器之ulipad的使用实践，文中介绍的非常详细，对大家具有一定的参考价值，需要的朋友们下面来一起看看吧。
2017-03-03
Python利用subplots_adjust方法解决图表与画布的间距问题
这篇文章主要介绍了如何在使用python 的 matplotlib库绘图时，使用subplots_adjust()方法来调整图表与画布之间的间距，以及图表与图表之间的间距，感兴趣的可以了解一下
2022-04-04
sklearn-SVC实现与类参数详解
今天小编就为大家分享一篇sklearn-SVC实现与类参数详解，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2019-12-12
Django User 模块之 AbstractUser 扩展详解
这篇文章主要介绍了Django User 模块之 AbstractUser 扩展详解，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-03-03
python发腾讯微博代码分享
本文介绍了利用qwebview写的一个发腾讯微博的功能，大家可以改成新浪微博，原理是一样的，大家参考使用吧
2014-01-01
Django haystack实现全文搜索代码示例
这篇文章主要介绍了Django haystack实现全文搜索代码示例,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-11-11