配置 Poetry 环境
Poetry 是一款工具,可根据项目依赖项便捷地创建 Python 虚拟环境。 您可以声明项目所依赖的库,Poetry 会为您安装并更新它们。
项目依赖项记录在 pyproject.toml 文件中,其中指定所需的包、脚本、插件和 URL。 请参阅 pyproject 参考,了解其结构和格式的详细信息。
要在 PyCharm 中使用 Poetry,您需要 在您的计算机上安装它并创建特定的 Python 环境。
安装 Poetry
打开 Terminal(在 macOS 和 Linux 上)或 PowerShell(在 Windows 上),然后执行以下命令:
curl -sSL https://install.python-poetry.org | python3 -(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -curl -sSL https://install.python-poetry.org | python3 -在 macOS 和 Windows 上,安装脚本将建议把包含 Poetry 可执行文件的文件夹添加到 PATH 变量。 通过运行以下命令来完成:
export PATH="/Users/jetbrains/.local/bin:$PATH"$Env:Path += ";C:\Users\jetbrains\AppData\Roaming\Python\Scripts"; setx PATH "$Env:Path"请记得将
jetbrains替换为您的用户名!要验证安装,请运行以下命令:
poetry --version您应会看到类似于
Poetry (version 1.2.0)的内容。
有关更多信息,请参阅 Poetry 安装说明。
创建 Poetry 环境
请执行以下任一操作:
点击 Python 解释器选择器 ,并选择 添加新解释器。
按下 Ctrl+Alt+S 打开 设置 ,并导航到 。
点击 Python 解释器选择器 ,并选择 解释器设置。 点击可用解释器列表旁的 添加解释器 链接。
点击可用解释器列表旁的 添加解释器 链接,并选择 添加本地解释器。
接下来的操作取决于您是要创建新的 Poetry 环境,还是使用现有环境。
- 新建 Poetry 环境

从环境类型列表中选择 Poetry。
从列表中选择基础解释器,或点击
,在您的文件系统中找到 Python 可执行文件。
PyCharm 将检测到 Poetry 安装。
如果 PyCharm 未检测到 Poetry 安装,请点击 通过 pip 安装 poetry ,允许 PyCharm 为您自动安装 Poetry。
或者,指定 Poetry 可执行文件的位置,或点击
进行浏览。
- 现有 Poetry 环境

从环境类型列表中选择 Poetry。
PyCharm 将检测到 Poetry 安装。
如果 PyCharm 未自动检测到该安装,请指定可执行文件的位置,或点击
进行浏览。
从列表中选择环境。
所选 Poetry 环境将在当前项目中重用。
点击 确定 完成任务。
如果您在 创建新的 Python 项目时选择了 Poetry 环境,PyCharm 将创建包含项目需求的 pyproject.toml 。
每次您修改 pyproject.toml 文件,PyCharm 会通知您,并提供两个操作:将更改记录到 poetry.lock 文件(poetry lock ),或记录更改并安装未满足的需求(poetry update)。

使用 pyproject.toml 创建 Poetry 环境
当您打开包含 pyproject.toml 的项目,但未配置项目解释器时,PyCharm 会建议您设置 Poetry 环境。

PyCharm 将显示 Poetry 可执行文件的路径。 点击 确定 确认路径。
如果 PyCharm 无法自动检测到 Poetry 可执行文件,请手动指定其路径。
将为您的项目配置新的 Poetry 环境,并安装 pyproject.toml 中列出的包。