DataBuddy Studio 中的 Notebook 文件以
.ipynb 为扩展名，按单元格（Cell）组织代码。本节介绍 Notebook 编辑器的单元格管理、多语法切换、多人协同和版本管理等基础能力。运行相关内容请参考 Notebook 运行。概述
Notebook IDE 提供与 Jupyter Notebook 类似的开发体验：
默认单元格语言为 Python；通过魔法命令切换 SQL、Markdown 等语法。
单元格支持新建、上移、下移、删除、隐藏运行结果等操作。
支持多人协作：支持多人编辑场景下的提示功能，可查看当前文件的编辑人列表。
文件支持手动保存与版本管理，最多保留 200 个保存版本。
前提条件
已加入工作空间，且对当前 Notebook 文件具备「编辑」或「管理」权限。
已创建或拥有可访问的 Notebook 文件。
操作步骤
步骤 1：打开或新建 Notebook 文件
1. 在 Studio 左侧 开发目录 中：
单击已有的
.ipynb 文件直接打开。或单击 + 新建 > Notebook ，输入文件名并选择父文件夹后单击 确定 。
1. 文件以 Tab 形式打开在右侧编辑器。
步骤 2：管理单元格
操作栏 + 代码/文本 支持新增单元格，类型包括：
类型 | 说明 |
代码 | 默认为 Python 语法类型，支持用户切换为 SQL 语法。 |
文本 | 用于撰写说明文字，支持完整 Markdown 语法。 |
每个单元格支持进行如下快捷操作：
操作 | 说明 |
执行单元格 | 支持执行当前单元格、执行上方所有的单元格、执行当前单元格及以下。 |
上移 / 下移 | 调整单元格顺序。 |
隐藏结果 | 折叠单元格运行结果展示区域。 |
删除 | 删除当前单元格。 |
步骤 3：通过魔法命令切换语法
在 Python 单元格首行使用魔法命令切换该单元格的语言：
魔法命令 | 切换后的语法 |
%sql | Spark SQL |
%md | Markdown |
%scala | Scala |
%sqlSELECT * FROM your_catalog.your_schema.your_table LIMIT 10;
提示
魔法命令只对当前单元格生效；切换语法后，该单元格的代码将被对应解释器执行。
步骤 4：使用代码补全与语法检测
自动补全 ：输入数据库、表、视图、字段、函数名时，编辑器会基于已绑定的数据目录给出补全建议；输入 Python 库名（如
pandas、numpy）也会展示常用 API。语法检测 ：单元格在编辑过程中会高亮 Python 语法错误、缩进错误、未定义变量等问题，并在出错行左侧显示红色波浪线。
括号匹配 ：自动配对
()、[]、{}、单引号、双引号。步骤 5：保存与查看版本
自动缓存 ：离开编辑器或定时触发自动保存。再次打开文件时自动恢复最新草稿。
手动保存 ：单击操作栏 保存 或使用快捷键
⌘ + S，生成一条版本记录。查看版本 ：在右侧 版本管理 抽屉中查看历史版本，每个版本展示版本号、保存人、保存时间、描述。
版本对比、回滚 ：选择两个版本进行差异对比，或选择历史版本执行回滚。
提示
最多保留 200 个手动版本；超出后从最早的版本开始覆盖。
步骤 6：多人协同
用户 A 打开文件进入编辑状态时，如果其他用户 B 正在编辑同一个 Cell，则会在 Cell 右上角显示当前编辑人列表，从而对用户进行提示，降低文件内容互相覆盖的风险。
参数说明
Notebook 快捷键（Mac 键位）
快捷键 | 操作 |
Y | 切换为 Code Cell |
M | 切换为 Markdown Cell |
D, D | 删除当前 Cell |
⌘ + Enter | 运行当前 Cell |
⇧ + Enter | 运行当前 Cell 并选中下一个 |
Windows 用户请将
⌘ 替换为 Ctrl，⇧ 替换为 Shift。支持版本管理的文件类型
.ipynb / .py / .sql / .r / .scala / .sh / .json / .yaml / .yml / .md / .txt / .csv使用限制
单文件最多保留 200 个手动版本，自动缓存内容不计入版本。
%sql 等非 Python 魔法命令的具体支持范围依赖底层引擎，详见 辅助工具（DLCUtils、魔法命令）。
