DataSpell 2025.2 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 环境
    • 从环境类型列表中选择 Virtualenv

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

      如果列表中没有所需的解释器,请单击 ,然后浏览以找到所需的 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年 9月 27日