DataSpell 2025.3 Help

配置一个 virtualenv 环境

DataSpell 使您可以使用 virtualenv工具来创建特定项目的隔离 虚拟环境。 虚拟环境的主要目的是管理特定项目的设置和依赖项,而不受其他 Python 项目的影响。 virtualenv工具与 DataSpell 一起提供,因此用户无需安装它。

创建 virtualenv 环境

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

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

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

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

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

  3. 以下操作取决于您是要生成新的虚拟环境还是使用现有的虚拟环境。

    新的 virtualenv 环境
    1. 从环境类型列表中选择 Virtualenv。

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

    3. 在 位置 字段中指定新的虚拟环境的位置,或者点击 虚拟环境位置 并在您的文件系统中浏览位置。 新虚拟环境的目录应为空。

    4. 如果您希望将机器上全局 Python 中安装的所有包都添加到您将要创建的虚拟环境中,请选择 继承基础解释器中的包 复选框。 此复选框对应 --system-site-packages 选项的 virtualenv 工具。

    5. 如果您希望在 DataSpell 中创建 Python 解释器时重用此环境,请选中 使所有项目可用 复选框。

    现有的 virtualenv 环境
    • 从环境类型列表中选择 Python。

    • 从列表中选择所需的解释器。

      如果列表中没有所需的解释器,请单击 ,然后浏览以找到所需的 Python 可执行文件(例如,macOS 上的 venv/bin/python 或 Windows 上的 venv\Scripts\python.exe )。

    已选择的虚拟环境将为当前项目重复使用。

  4. 点击 确定 完成任务。

您可以根据需要创建任意数量的虚拟环境。 为了便于区分它们,请使用不同的名称。

使用现有的解释器

  1. 按 Ctrl+Alt+S 打开设置,然后选择 项目 <project name> | Python 解释器。

  2. 展开可用解释器列表,然后单击 显示全部 链接。 或者,单击 配置项目解释器 图标并选择 显示全部。

    显示所有可用的解释器

    虚拟环境用 虚拟环境 标记。

  3. 从列表中选择目标环境,然后单击 确定 以确认您的选择。

    选择一个虚拟环境

当您想要升级环境所基于的 Python 版本时,例如从 3.5 升级到 3.9,这种方法特别有用。 您可以指定一个新的基础解释器,并使用 requirements.txt 来确保安装所有必要的包。

最后修改日期: 2025年 12月 16日