以下是 Poetry 的核心命令及其功能说明，按功能分类整理：
一、项目初始化与配置
| 命令 | 说明 |
|---|---|
poetry new <project-name> | 创建新项目结构（含pyproject.toml、README.rst等） |
poetry init | 交互式创建pyproject.toml文件 |
poetry version | 查看/修改项目版本号 |
poetry config | 配置虚拟环境路径（如virtualenvs.in-project true） |
二、依赖管理
| 命令 | 说明 |
|---|---|
poetry add <package> | 安装依赖并写入pyproject.toml |
poetry add --dev <package> | 安装开发依赖（如测试工具） |
poetry remove <package> | 移除依赖 |
poetry update | 更新所有依赖到兼容的最新版本 |
poetry show | 查看已安装依赖及其版本 |
poetry show --tree | 以树状结构显示依赖关系 |
poetry lock | 锁定当前依赖版本 |
三、虚拟环境管理
| 命令 | 说明 |
|---|---|
poetry install | 安装依赖并创建虚拟环境（若未存在） |
poetry shell | 激活虚拟环境（进入 shell） |
poetry run <command> | 在虚拟环境中执行命令（无需激活环境） |
poetry env info | 显示当前环境信息 |
poetry env list | 查看所有虚拟环境 |
poetry env remove <env> | 删除虚拟环境 |
poetry env use <python-path> | 指定虚拟环境的 Python 解释器路径 |
四、其他常用命令
| 命令 | 说明 |
|---|---|
poetry self update | 更新 Poetry 到最新版本 |
poetry build | 构建项目（打包） |
poetry publish | 发布项目到 PyPI（需配置） |
