以下是 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（需配置） |