Poetry管理工具

配置

查看所有配置

poetry config --list

虚拟环境在项目目录中

配置全局设置，让虚拟环境存储在项目目录内：

poetry config virtualenvs.in-project true

配置镜像源

poetry config pypi-mirror https://pypi.tuna.tsinghua.edu.cn/simple

初始化

创建新项目

poetry new my-project

会生成如下的目录结构：

my-project/
├── README.md        # 项目说明
├── pyproject.toml   # 项目配置
├── my_project/      # 代码目录
│   └── __init__.py
└── tests/           # 测试目录
    └── __init__.py

使用现有项目

cd existed-project
poetry init

先进入项目所在目录，再初始化；之后会通过命令行交互配置项目 pyproject.toml 。

依赖管理

添加依赖

通过 poetry add 添加依赖，添加时会同步更新 pyproject.toml 和 poetry.lock 。

例如安装 requests:

poetry add requests

指定版本：

poetry add requests@^2.28.0

仅添加到开发环境（比如仅用于测试）：

poetry add pytest --group dev

删除依赖

poetry remove requests

查看依赖

列出所有已安装的依赖

poetry  show

以树图形式查看依赖

poetry show --tree

锁定依赖

Poetry 使用 poetry.lock 文件锁定依赖的确切版本，确保一致性。

更新锁文件：

poetry lock

更新依赖到最新兼容版本：

poetry update

虚拟环境管理

激活和退出

poetry shell

exit

检查环境

查看当前虚拟环境信息：

poetry env info

列出所有虚拟环境：

poetry env list

删除虚拟环境：

poetry env remove python3.10

其他

升级poetry

poetry self update

使用特定版本python

如果系统中安装了多个 Python 版本，可以指定 Poetry 使用的版本：

poetry env use python3.10

导出 requirements.txt

poetry export -f requirements.txt --output requirements.txt