DataSpell 2025.2 Help

创建项目

Python 项目旨在管理 Jupyter 笔记本和 Python 脚本。 项目帮助您将源代码、测试、使用的库以及您的个人设置组织为一个单元。

有关创建 R 项目的更多信息,请参阅 R 插件支持

创建一个 Python 项目

  1. 要创建项目,请执行以下操作之一:

    • 单击 项目小部件 ,然后选择 新建项目

      单击项目小部件
    • 欢迎屏幕上,选择 项目 ,然后单击 新建项目

  2. 新建项目 对话框中,选择所需的项目类型:

    Jupyter

    项目虚拟环境已预装 Jupyter。 默认情况下,使用 conda 虚拟环境

    pandas 表格

    项目虚拟环境已预装以下软件包:

    • pandas

    • matplotlib

    • numpy

    • Jupyter(可选)

    默认情况下,使用 conda 虚拟环境

    Polars 表格

    项目虚拟环境已预装以下软件包:

    • Polars

    • matplotlib

    • Jupyter(可选)

    默认情况下,使用 virtualenv 环境

    纯 Python

    项目虚拟环境不包含任何预装的软件包,Jupyter 除外(可选)。 默认情况下,使用 conda 虚拟环境

    dbt

    项目虚拟环境已预装 dbt® 软件包。 默认情况下,使用 virtualenv 环境

  3. 名称 字段中指定项目名称,并在 Location 字段中指定位置。 DataSpell 将在提供的位置创建项目目录。

    创建纯 Python 项目
  4. 选中 创建Git 仓库 复选框,将新项目置于版本控制之下。

    您可以在任何时候完成此操作。

  5. 如果您希望 DataSpell 将 sample.ipynb 添加到您的项目中,请保持 创建示例Jupyter Notebook 启用。 在这种情况下,Jupyter 将安装在项目虚拟环境中。

    如果需要,请启用 创建示例Python 脚本 以添加带有基本 Python 代码示例的 main.py

  6. 对于 dbt 项目类型,您将需要一个 profiles.yml 文件 ,其中存储了数据库连接设置。

    指定 配置文件位置 并选择 要加载的配置文件

    指定 dbt 配置文件
  7. 如果需要,展开 解释器设置 部分并配置环境选项。 您可以选择 CondaVirtualenv

    为新项目配置 conda 环境
    • 指定环境名称。

    • DataSpell 将检测 conda 安装。

      如果 DataSpell 未能自动检测到该安装,请指定 conda 可执行文件的位置,或单击 Conda 可执行文件位置 进行浏览。

    为新项目配置 virtuaenv 环境
    • 从列表中选择基础解释器,或者单击 选择基础解释器 并在您的文件系统中找到 Python 可执行文件。

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

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

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