手把手教你打开 ModelScope Notebook：零基础也能跑起来的云端 Python 环境
一、什么是 ModelScope？为什么用它？
ModelScope（魔搭社区）是阿里达摩院推出的 AI 模型开源社区，定位类似于 AI 界的 GitHub，也是国内版的 Hugging Face。它提供了三样东西：
- Model：大量开源模型的发布与下载平台
- Dataset：公开数据集的托管与使用
- Notebook：免费的云端 Python 运行环境，内置 GPU 资源
对于学习 Python、跑 AI 实验的同学来说，Notebook 是最核心的功能——不用配本地环境，打开浏览器就能写代码、跑模型。
二、注册账号
打开浏览器，访问 ModelScope 官网：
点击右上角的**「登录/注册」**按钮，支持以下方式注册：
- 手机号注册（推荐）
- 阿里云账号登录
- GitHub 账号登录
填写手机号，获取验证码，完成注册。整个过程大约一分钟。
注：注册完成后建议完善一下个人信息，部分资源需要实名认证才能使用。
三、进入我的 Notebook
3.1 找到入口
登录成功后，将鼠标悬停在右上角的头像上，下拉菜单中找到**「我的Notebook」**并点击。
也可以通过顶部导航栏 「工具」→「Notebook」 进入。
3.2 Notebook 列表页
进入后会看到 Notebook 列表页，首次使用时列表为空。
四、新建一个 Notebook
点击右上角的**「新建Notebook」**按钮。
弹出配置面板，需要选择以下选项：
4.1 选择运行环境
| 选项 | 说明 |
|---|---|
| CPU 环境 | 免费，适合 Python 学习、数据处理、调用 API |
| GPU 环境 | 部分免费额度，适合训练模型、跑推理 |
初学 Python 或调用 LLM API，选 CPU 环境即可，完全免费，无需消耗 GPU 额度。
4.2 选择镜像
镜像决定了预装的软件环境。一般选默认的 「官方镜像」 即可，已内置了 Python、常用数据科学库（numpy、pandas）以及 openai 等 AI 相关包。
4.3 填写名称
给 Notebook 起一个名字，比如 python-learning 或 llm-practice，方便后续管理。
点击**「确定」**，等待几秒钟，Notebook 实例启动。
五、进入 Notebook 界面
启动完成后，列表中会出现刚才创建的 Notebook，状态显示为**「运行中」。点击「打开」**按钮进入。
浏览器会打开一个新标签页，这就是 JupyterLab 界面——ModelScope Notebook 的核心编辑器。
六、JupyterLab 界面说明
第一次看到这个界面可能有点懵，简单认识一下各个区域：
┌─────────────────────────────────────────────────────────┐
│ 菜单栏（File / Edit / Run / Kernel...） │
├──────────────┬──────────────────────────────────────────┤
│ │ │
│ 左侧 │ 主编辑区 │
│ 文件树 │ （代码单元格 / Markdown 单元格） │
│ │ │
│ │ │
├──────────────┴──────────────────────────────────────────┤
│ 底部状态栏（内核状态 / 行列位置） │
└─────────────────────────────────────────────────────────┘
| 区域 | 作用 |
|---|---|
| 左侧文件树 | 管理文件，新建、上传、删除 .ipynb 文件 |
| 主编辑区 | 编写和运行代码的地方 |
| 菜单栏 → Run | 运行单元格的快捷操作 |
| 内核状态 | 显示 Python 内核是否就绪（圆圈实心=忙碌，空心=空闲） |
七、新建 .ipynb 文件并运行第一行代码
7.1 新建文件
在左侧文件树空白处右键 → 选择**「New Notebook」**，或者点击主编辑区 Launcher 页面中的 「Python 3」 图标。
新建后会自动打开一个 .ipynb 文件，里面已经有一个空的代码单元格，光标等待输入。
7.2 写下第一行代码
点击单元格，输入：
print("My first NoteBook")
7.3 运行代码
有三种方式运行当前单元格：
| 方式 | 操作 |
|---|---|
| 键盘快捷键（推荐） | Shift + Enter：运行并跳到下一个单元格 |
| 键盘快捷键 | Ctrl + Enter：运行并停留在当前单元格 |
| 点击按钮 | 工具栏中的 ▶ 运行按钮 |
运行后，单元格下方会出现输出结果：
My first NoteBook
恭喜，第一行 Python 代码成功跑起来了。
八、几个常用操作
熟悉界面之后，这几个操作会经常用到：
8.1 新增单元格
- 点击单元格左侧的
+按钮 - 或者按
B（在当前单元格下方新增）/A（上方新增）
8.2 切换单元格类型
单元格默认是代码类型（Code），也可以切换为 Markdown 类型，用来写笔记和说明文字：
点击工具栏的下拉菜单，将 Code 改为 Markdown，输入文字后按 Shift + Enter 渲染。
8.3 保存文件
Ctrl + S 手动保存，Notebook 也会定期自动保存。文件名默认是 Untitled.ipynb，建议右键文件名重命名。
8.4 重启内核
如果代码运行卡住，或者想清空所有变量重新开始，点击菜单栏 「Kernel」→「Restart Kernel」。
九、关闭与重新打开 Notebook
使用完成后，直接关闭浏览器标签页即可，代码文件会保存在云端。
下次使用时：
- 登录 ModelScope
- 进入「我的 Notebook」
- 找到对应实例，点击「启动」（如果已停止）或「打开」（如果仍在运行）
注意：免费实例有闲置自动停止机制，长时间没有操作会自动关闭以节省资源。重新启动只需点击「启动」按钮，等待约 30 秒即可恢复，代码文件不会丢失。
十、小结
整个流程回顾一下：
注册账号
↓
进入「我的 Notebook」
↓
新建 Notebook（选 CPU 环境）
↓
等待启动 → 点击「打开」
↓
新建 .ipynb 文件
↓
写代码 → Shift + Enter 运行
ModelScope Notebook 的最大优势是零配置——不用装 Python，不用管依赖，不用担心系统兼容性，打开浏览器就是一个完整的 Python 运行环境。对于刚开始学习的同学来说，把精力放在代码本身，而不是环境搭建上，是最正确的起点。
