DataSpell 2025.3 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. 如果需要,展开 解释器设置 部分并配置环境选项。 您可以选择 Conda 或 Virtualenv:

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

    • DataSpell 将检测到 conda 安装。

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

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

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

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

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