Poetry包管理器常用命令详解与创建项目全流程指南

poetry new <project-name> 创建一个新的 Python 项目。

poetry new my_project

会生成一个新的文件夹 my_project，其中包含一个基础的 Python 项目结构（pyproject.toml、README.rst、tests/ 等）。

poetry init 在现有目录中初始化一个新的 pyproject.toml 文件，并逐步引导你配置项目的元数据和依赖项。

poetry add <package> 向项目中添加一个新的依赖包。默认安装最新版本。

poetry add requests

你可以通过指定版本来安装特定版本：

poetry add requests@2.25.0

poetry add <package> --dev 向项目中添加开发依赖（例如用于测试、构建工具等）。这些依赖不会出现在生产环境中。

poetry add pytest --dev

poetry remove <package> 移除项目中的某个依赖包。

poetry remove requests

poetry show 显示当前项目的所有已安装依赖及其版本信息。

poetry show

poetry show <package> 显示指定包的信息（如版本、依赖关系等）。

poetry show requests

poetry install 安装项目中列出的所有依赖包，基于 pyproject.toml 和 poetry.lock 文件。这个命令会自动创建虚拟环境（如果尚未创建）。

poetry install

poetry update 更新所有依赖包到最新版本（符合 pyproject.toml 中的版本要求）。

poetry update

poetry env info 查看当前虚拟环境的信息。

poetry env info

poetry env list 列出所有虚拟环境。

poetry env list

poetry shell 激活虚拟环境，进入一个新的 shell 会话。

poetry shell

poetry run <command> 在项目的虚拟环境中执行命令。例如，运行 pytest 进行测试：

poetry run pytest

poetry build 构建项目包，将其打包为 .tar.gz 和 .whl 文件，准备发布到 PyPI 或其他包管理平台。

poetry build

poetry publish 将项目包发布到 PyPI 或其他指定的 Python 包索引。

poetry publish --build

发布时可以指定上传的包索引：

poetry publish --repository <repository-name> --build

poetry check 检查 pyproject.toml 文件和项目的完整性，确保没有错误。

poetry check

poetry lock 锁定项目的依赖版本并生成或更新 poetry.lock 文件。通常在更改依赖或版本时自动运行。

poetry lock

poetry config 配置 Poetry 设置（如缓存目录、PyPI 源等）。

poetry config --list poetry config cache-dir /path/to/cache

poetry help 查看帮助信息，列出所有可用命令和选项。

poetry help