Poetry是一个基于项目依赖关系创建 Python 虚拟环境的工具。您可以声明您的项目所依赖的库,Poetry 将为您安装和更新它们。
项目依赖项记录在pyproject.toml文件中,该文件指定所需的包、脚本、插件和 URL。有关其结构和格式的更多信息,请参阅pyproject参考。
要在 PyCharm 中使用 Poetry,您需要在您的机器上安装它并创建一个特定的 Python 环境。
打开终端窗口(Windows 上的 PowerShell)并执行特定于您的操作系统的以下命令:
curl -sSL https://install.python-poetry.org | python -
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -
curl -sSL https://install.python-poetry.org | python -
在 Poetry bin 目录中验证安装:
路径:$HOME/.poetry/bin
示例:/Users/jetbrains/.poetry/bin/poetry
路径:%USERPROFILE%\.poetry\bin
示例:C:\Users\jetbrains\.poetry\bin\poetry.bat
路径:$HOME/.poetry/bin
示例:/home/jetbrains/.poetry/bin/poetry
有关详细信息,请参阅诗歌安装说明。
这些目录会自动添加到$PATH
变量中,以便 PyCharm 在创建 Poetry 虚拟环境时可以选择它。
执行以下操作之一:
单击Python 解释器选择器并选择 。
按Ctrl+Alt+S打开项目设置/首选项并转到 。然后单击图标并选择添加。
按下Ctrl+Alt+S并转到并选择添加。
在Add Python Interpreter对话框的左侧窗格中,选择Poetry Environment。以下操作取决于之前是否存在虚拟环境。
如果选择诗歌环境:
从列表中选择基本 Python 解释器,或单击并在文件系统中找到它的位置。
如果 PyCharm 没有找到 Poetry 路径,请单击Poetry 可执行文件附近并导航到其位置。然后在资源管理器窗口中单击“确定”将其添加到该字段。
如果选择现有环境:
展开解释器列表并选择任何现有的诗歌环境。或者,单击并指定它的路径。
单击确定以完成任务。
如果您在创建新的 Python 项目时选择 Poetry 环境,PyCharm 会在您的项目中添加两个文件:
pyproject.toml:指定项目要求
诗歌锁:记录项目需求的变化
每次您修改pyproject.toml文件时,PyCharm 都会通知您并提供两个操作:在poetry.lock文件中记录更改或记录更改并安装未满足的要求。