poetry

Python 项目依赖与打包管理

补充说明

poetry 用 pyproject.toml 管理依赖、虚拟环境和发布，锁文件是 poetry.lock。它适合应用和库项目，但不是 Python 标准库的一部分。

常用示例

poetry new myapp
poetry init
poetry add requests
poetry add --group dev pytest
poetry install
poetry install --no-root
poetry lock
poetry update
poetry run python app.py
poetry run pytest -q
poetry shell
poetry env info
poetry build
poetry publish

易错点与排错

• poetry install 默认会安装项目本身；纯应用可加 --no-root。
• lockfile 与 pyproject.toml 不一致时构建会失败；先 poetry lock 再提交。
• poetry run 只在当前项目环境执行；换目录后环境可能不同。
• poetry shell 依赖 shell 支持；CI 里优先 poetry run。
• 项目不是包时要在 pyproject.toml 设 package-mode = false。
• 2.x 的 poetry export 可能需要额外插件；不要假设默认可用。
• 私有源和认证配置写在 poetry.toml/环境变量里，不要提交凭据。
• 虚拟环境默认放在缓存目录；要项目内 .venv 就设 virtualenvs.in-project = true。

相关命令

• python — 解释器
• uv — 更快的替代方案
• pip — 传统包安装