一、概述
Python IDE 与 Notebook、SQL 共用同一套 Studio 工作台，特点如下：
·完整 Python 语法 ：支持完整 Python 3 语法，不强制单元格化。
·元数据感知 ：可在编辑器中调用统一 Catalog API 操作库表。
·跨文件引用 ：支持在同目录下通过 import 引用其他 .py 模块。
·AI 助手 ：内置 Buddy 协助代码生成、补全、纠错。
·版本管理 ：每次手动保存生成一个版本，最多 200 个。
二、前提条件
·已加入工作空间，且对当前 Python 文件具备「编辑」或「管理」权限。
·已创建或拥有可访问的 Python 文件。
三、步骤 1：打开或新建 Python 文件
1. 在 Studio 左侧 开发目录 中：
·单击已有的 .py 文件直接打开。
·或单击 + 新建 > Python ，输入文件名并选择父文件夹后单击确定 。
2. 文件以 Tab 形式打开在右侧编辑器。
四、步骤 2：编写 Python 代码
Python 编辑器具备以下能力：
| 能力 | 说明 |
| 语法高亮 | 关键字、字符串、数字、注释、装饰器分别着色。 |
| 自动补全 | 输入标准库（os、json）、常用三方库（pandas、numpy）、当前文件已定义的函数与变量时实时联想。 |
| 错误检测 | 语法错误、未定义变量、类型错误实时高亮。 |
| 括号匹配 | 自动配对 ()、[]、{}、单引号、双引号。 |
五、步骤 3：跨文件引用
支持通过标准 import 引用同工作空间内的其他 .py 文件：
六、3.1 同目录引用
your_folder/├── utils.py└── main.py
# main.pyfrom utils import add_numbersresult = add_numbers(1, 2)print(result)
七、3.2 子目录引用
子目录需要包含 __init__.py，或使用相对路径写法：
from sub_folder import helper
八、3.3 注意事项
·本地文件夹和 Git 文件夹下的文件均可被引用。
·引用范围以当前用户在 Studio 内拥有可见权限的文件为准。
九、步骤 4：与 Notebook 文件系统交互
Python 文件运行时可读写工作空间下的文件：
import pandas as pd# 读取 CSVdf = pd.read_csv('your_folder/data.csv')# 写出df.to_csv('your_folder/result.csv', index=False)
详见 Python 文件运行 的「文件系统交互」章节。
十、步骤 5：使用 AI 助手
·选中 Python 片段后右键 Buddy > 解释 ：AI 解释当前代码含义。
·选中错误片段右键 Buddy > 纠错 ：AI 修复语法错误并给出建议。
·输入自然语言注释后右键 Buddy > 续写 ：AI 基于注释生成代码。
·详细 AI 助手用法请参考 代码辅助。
十一、步骤 6：保存与版本管理
·自动保存 ：编辑过程中自动缓存草稿。
·手动保存 ：单击操作栏 保存 或 ⌘ + S，生成一个版本记录。
·版本对比、回滚 ：在右侧 版本管理 抽屉查看历史版本，支持对比与回滚。
十二、编辑器顶部操作栏
| 操作 | 说明 |
| 全部运行 | 执行整个 Python 文件。 |
| 运行选中 | 选中片段后单击 运行选中 仅执行选中代码（在交互式 REPL 中执行）。 |
| 停止 | 终止当前运行。 |
| 保存 | 生成一个手动版本。 |
| 格式化 | 按 PEP 8 规范统一缩进与空白。 |
十三、常用快捷键
| 快捷键 | 操作 |
| ⌘ + Enter | 运行光标所在行 / 选中代码 |
| Ctrl + ⇧ + Enter | 运行全部 |
| ⌘ + S | 保存 |
| ⌘ + ⇧ + F | 格式化 |
| ⌘ + / | 注释 / 取消注释 |
十四、使用限制
·dlcutils 函数库可在 Python 文件中使用，行为与 Notebook 一致。
·跨文件引用仅适用于工作空间内的文件，无法引用本地磁盘上的 .py。
·Python 解释器版本与所选计算资源镜像一致；如需特定版本，请在新建 Kernel 时选择对应版本的计算资源。
十五、常见问题
Q1：import utils 报 ModuleNotFoundError？
·检查 utils.py 是否与当前文件在同一目录。
·跨目录引用需要确保父目录是 Python 包（包含 __init__.py）。
·检查文件名是否为合法 Python 标识符（不含中文、横线）。
Q2：Python 文件能直接发布到 Workflow 吗？
可以。Workflow 中的 Python File 任务支持引用 Studio 中的 .py 文件。详见 Python File 任务。
Q3：Python 文件支持 Debug 模式吗？
支持。在编辑器中设置断点后单击 Debug 运行 ，可逐行调试并查看变量。
十六、相关文档
·Python 文件运行
·辅助工具（DLCUtils、魔法命令）
·Git 初始化配置 / GitFolder 创建、源代码管理操作