DataSpell 是 JetBrains 公司专为数据科学家和机器学习工程师打造的专业集成开发环境（IDE）。它深度集成了 Jupyter Notebook 的支持，并提供了强大的数据库工具、科学计算环境以及版本控制功能，旨在提供一个高效、流畅的数据分析和模型开发工作流。本指南将详细介绍其在 macOS 系统下的核心功能与操作流程。
一、核心界面与工作区详解
启动 DataSpell 后，您将看到一个高度可定制且功能分区明确的主界面。
1.1 主要工作区组件
- 菜单栏与工具栏：位于窗口顶部，提供文件、编辑、视图、运行、工具等所有高级功能的入口。工具栏可自定义，常放置运行、调试、VCS等快捷按钮。
- 项目工具窗口（左侧）：默认位于左侧，以树状结构显示项目中的所有文件、目录和数据集。这是您导航项目结构的核心区域。
- 编辑区（中央）：界面的核心区域。打开
.ipynb(Jupyter Notebook) 文件时，会显示为交互式的单元格界面；打开.py等脚本文件时，则显示为经典代码编辑器。 - 科学模式工具窗口（右侧）：DataSpell 的特色功能。当在 Notebook 或科学模式下运行代码时，此处会动态显示变量、数据帧、图表和绘图。您可以在此交互式地探索数据。
- 运行/调试工具窗口（底部）：显示代码执行输出、终端、Python 控制台、TODO 列表以及版本控制（如 Git）的变更信息。
- 状态栏（底部）：显示当前项目状态，如 Python 解释器版本、Git 分支、内存指示器等。
二、完整工作流程：从项目创建到结果导出
2.1 创建或打开项目
步骤 1：启动与创建 启动 DataSpell，在欢迎界面点击 “New Project”。在弹出的对话框中，指定项目位置（Location），并选择项目类型（如纯 Python 项目）。最关键的是在 “Python Interpreter” 下拉菜单中为新项目选择或创建一个 Conda、Virtualenv 或系统解释器。点击 “Create”。
步骤 2：打开现有项目 在欢迎界面点击 “Open”，导航到现有项目目录（包含 .idea 文件夹或项目文件）并选择打开。
2.2 创建并编辑 Notebook 文件
步骤 1：新建文件 在项目工具窗口中，右键点击目标目录，选择 New -> Jupyter Notebook。或使用快捷键 ⌘N（在项目窗口激活时）然后选择 Notebook 类型。
步骤 2：编辑单元格 Notebook 由代码单元格和 Markdown 单元格组成。
- 添加单元格： 将鼠标移至单元格上下边缘，点击出现的 “+” 按钮。或使用快捷键
⌥⌘A（上方插入），⌥⌘B（下方插入）。 - 切换单元格类型： 选中单元格，在单元格工具栏（或按
⌘M后接Y切换为代码，⌘M后接M切换为 Markdown）。 - 编写代码： 在代码单元格中直接输入，享受智能代码补全（
⌃Space）、参数提示等。 - 编写文档： 在 Markdown 单元格中使用 Markdown 语法，预览可通过点击单元格右侧的渲染图标。
2.3 运行代码与探索结果
步骤 1：执行单元格 将光标置于目标单元格内，点击单元格左侧的播放按钮，或使用快捷键 ⇧↩（运行当前单元格并选中下一个）。⌃↩ 仅运行当前单元格。
步骤 2：查看科学模式输出 代码运行后，输出（如打印文本、图表）会直接显示在单元格下方。同时，右侧的 “科学模式” 工具窗口会自动刷新。
- 变量视图： 列出所有已定义的变量（如 DataFrames, arrays），点击变量名可快速查看其摘要。
- 数据视图： 双击一个 Pandas DataFrame 或 NumPy 数组变量，会弹出一个类似电子表格的视图，支持排序、筛选和探索。
- 绘图视图： 由 Matplotlib、Plotly 等库生成的图表会在此处陈列，可缩放、保存或全屏查看。
2.4 保存与导出项目成果
步骤 1：保存文件 DataSpell 支持自动保存，也可手动使用 ⌘S 保存当前文件。
步骤 2：导出 Notebook 要将 Notebook 转换为其他格式分享：
- 确保当前焦点在目标 Notebook 编辑器。
- 点击菜单栏 “File -> Export -> Export Notebook To…”。
- 在弹出的子菜单中，选择导出格式，如 HTML、PDF、Markdown 或 Python Script。
- 选择保存路径并确认。
三、常用功能进阶技巧
3.1 高效数据探索
- 交互式数据过滤： 在科学模式的数据视图中，点击列标题旁的漏斗图标，可以直接输入条件（如 `>100`）进行实时过滤。
- 图表内联与独立显示： 默认图表内联显示在单元格下。通过配置 `%matplotlib inline` 或使用科学模式窗口查看独立的高分辨率图表。
3.2 代码辅助与重构
- 智能重构： 选中变量名，按
⌃T，可以快速进行重命名（Rename）、提取变量（Extract Variable⌥⌘V）等重构操作，所有引用处会自动更新。 - 快速文档与定义： 将光标置于函数或类上，按
F1查看快速文档。按⌘B或⌘+鼠标点击跳转到其定义。
3.3 数据库工具集成
在右侧工具窗口栏，找到并打开 “Database” 工具窗口。点击 “+” 添加数据源（如 PostgreSQL, MySQL, SQLite），连接成功后，可以直接在 IDE 内编写 SQL 查询、浏览表结构、导入/导出数据，查询结果会以 DataFrame 形式返回，并可无缝用于后续分析。
四、常见问题与解决方案
Q1: 运行单元格时提示“No Python interpreter configured”或内核无法启动。
解决方案： 检查项目解释器配置。点击状态栏的 Python 解释器名称，或进入 “DataSpell -> Preferences -> Project: [项目名] -> Python Interpreter”。确保已为当前项目选择了一个有效的、已安装必要科学计算库（如 pandas, numpy）的解释器。可以点击“Add Interpreter”添加 Conda 或 Virtualenv 环境。
Q2: 科学模式工具窗口没有显示变量或数据。
解决方案： 首先确认代码已成功运行并定义了变量。然后检查科学模式是否已启用：在运行了代码的 Notebook 编辑器中，查看顶部是否有“科学模式已开启”的提示，或手动点击工具栏上的科学模式图标（烧杯形状）。确保“科学模式”工具窗口已在右侧打开。
Q3: 导入已安装的第三方库（如 `sklearn`）仍报错“ModuleNotFoundError”。
解决方案： 这通常是因为 IDE 使用的 Python 解释器与您安装库的解释器不是同一个。请严格按照 Q1 的方法确认并切换项目解释器到正确的环境。然后，可以在 DataSpell 内置的终端（⌥F12）中使用 `pip list` 验证库是否存在。
Q4: Notebook 单元格执行顺序错乱，导致变量未定义错误。
解决方案： DataSpell 支持乱序执行，但依赖关系需自行管理。可以重启内核（点击工具栏上的重启按钮）并按顺序重新运行所有单元格。使用 Kernel -> Restart & Run All 菜单项可以一次性完成。
五、Mac 版快捷键汇总表
| 功能分类 | 操作描述 | Mac 快捷键 |
|---|---|---|
| 通用操作 | 保存当前文件 | ⌘S |
| 查找任何内容（包括操作、文件、设置） | ⇧⌘A |
|
| 打开项目设置/偏好 | ⌘, |
|
| 导航与编辑 | 跳转到类/文件/符号 | ⌘O / ⇧⌘O |
| 显示快速文档 | F1 |
|
| 跳转到定义 | ⌘B |
|
| 代码补全（基本） | ⌃Space |
|
| 重命名重构 | ⇧F6 |
|
| Notebook 特定 | 在上方插入单元格 | ⌥⌘A |
| 在下方插入单元格 | ⌥⌘B |
|
| 运行当前单元格 | ⌃↩ |
|
| 运行当前单元格并选中下一个 | ⇧↩ |
|
| 切换单元格类型（代码/Markdown） | ⌘M Y / ⌘M M |
|
| 运行与调试 | 运行当前文件/单元格（上下文相关） | ⌃⇧R |
| 调试当前文件/单元格 | ⌃⇧D |
|
| 停止运行/内核 | ⌘F2 |
|
| 工具窗口 | 打开/关闭项目工具窗口 | ⌘1 |
| 打开/关闭科学模式工具窗口 | ⌘8 |
|
| 打开/关闭运行工具窗口 | ⌘4 |
|
| 打开终端 | ⌥F12 |
