DataSpell 2025.2 Help

配置 Poetry 环境

Poetry 是一个工具,可帮助基于项目依赖项创建 Python 虚拟环境。 您可以声明项目所依赖的库,Poetry 将为您安装和更新它们。

项目依赖项记录在 pyproject.toml 文件中,该文件指定所需的包、脚本、插件和 URL。 有关其结构和格式的更多信息,请参阅 pyproject 参考。

要在 DataSpell 中使用 Poetry,您需要 在您的机器上安装它并创建一个特定的 Python 环境。

安装 Poetry

  1. 打开终端(在 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 -
  2. 在 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 替换为您的用户名!

  3. 要验证安装,请运行以下命令:

    poetry --version

    您应该会看到类似 Poetry (version 1.2.0) 的内容。

有关更多信息,请参阅 Poetry 安装说明

创建一个 Poetry 环境

  1. 请执行以下操作之一:

    • 按下 Ctrl+Alt+S 以打开 设置 并导航到 项目:<project name> | Python 解释器

    • 单击 Python Interpreter 选择器 并选择 解释器设置。 单击可用解释器列表旁边的 添加解释器 链接。

    • 在附加目录的上下文菜单中,选择 解释器

  2. 单击 添加解释器 链接,该链接位于可用解释器列表旁边,然后选择 添加本地解释器

  3. 以下操作取决于您是想创建一个新的 Poetry 环境还是使用一个现有的环境。

    新的 Poetry 环境
    1. 从环境类型列表中选择 Poetry

    2. 从列表中选择基础解释器,或者单击 浏览… 并在您的文件系统中找到 Python 可执行文件。

    现有 Poetry 环境
    1. 确保项目目录包含一个 pyproject.toml 文件。

    2. 从列表中选择解释器。

      如果列表中没有所需的解释器,请单击 ,然后在先前配置的 Poetry 环境中浏览所需的 Python 可执行文件。

    所选的 Poetry 环境将用于当前项目。

  4. 点击 确定 完成任务。

当您配置一个新的 Poetry 环境时,DataSpell 会根据项目需求创建 pyproject.toml

每次您修改 pyproject.toml 文件时,DataSpell 会通知您并提供两个操作选项:将更改记录到 poetry.lock 文件中(poetry lock ),或记录更改并安装未满足的需求(poetry update)。

最后修改日期: 2025年 9月 27日