在 Python 项目开发中，依赖混乱和环境污染是常见痛点。poetry 提供了一套完整的依赖与虚拟环境管理方案，让项目结构更清晰、协作更顺畅。下面介绍它的核心用法。
poetry 是什么
poetry 是一个 Python 打包和依赖管理工具，使用 pyproject.toml 取代传统的 setup.py 与 requirements.txt，能够自动创建虚拟环境、解析依赖树并生成 lock 文件。
安装 poetry
推荐使用官方安装脚本，或使用 pipx 隔离安装：
# 使用官方脚本安装 curl -sSL https://install.python-poetry.org | python3 - # 或使用 pipx pipx install poetry # 验证版本 poetry --version
初始化项目
在空目录中运行 init 命令，按提示填写信息即可生成基础配置文件：
poetry init
执行后会得到如下内容的 pyproject.toml：
[tool.poetry] name = "demo" version = "0.1.0" description = "" authors = ["you <user@ipipp.com>"] [tool.poetry.dependencies] python = "^3.10" [build-system] requires = ["poetry-core"] build-backend = "poetry.core.masonry.api"
管理依赖
添加依赖
添加运行时或开发依赖，poetry 会自动更新 toml 与 lock 文件：
# 添加生产依赖 poetry add requests # 添加开发依赖 poetry add pytest --group dev
移除依赖
poetry remove requests
安装已有依赖
克隆项目后，一键安装全部锁定版本的依赖：
poetry install
运行与打包
在虚拟环境中执行脚本或进入 shell：
poetry run python main.py poetry shell
构建与发布包到仓库：
poetry build poetry publish
常用命令对比
| 需求 | pip 方式 | poetry 方式 |
|---|---|---|
| 安装包 | pip install xxx | poetry add xxx |
| 记录依赖 | pip freeze > requirements.txt | 自动写入 pyproject.toml |
| 环境隔离 | 需手动 venv | 自动创建 |
小结
使用 poetry 管理 Python 项目依赖，可以显著减少环境不一致问题。它将配置、锁版本与虚拟环境统一起来，适合个人与团队工程化实践。
poetryPython依赖管理虚拟环境修改时间：2026-07-28 21:00:33