QNotebook 交互编程——在手机上运行 Jupyter Notebook
什么是 Jupyter Notebook
Jupyter Notebook 是一种特殊的文档格式（.ipynb），它把代码、说明文字、公式、图表混排在同一个文件里。和传统的 .py 文件不同，Notebook 由一个个 Cell（单元）组成，每个 Cell 可以独立执行、独立显示结果。
典型的使用场景是数据分析和机器学习——一边写代码、一边写解释文字、一边看图表输出。全球很多在线学习平台和数据科学家都用 Notebook 来做工作流。
QNotebook 的定位
QNotebook 是 QPython 内置的 Notebook 浏览器——它提供一个类似网页浏览器的界面来打开和运行 .ipynb 文件。4.0 版本起 QPython 开始正式支持这个功能。
和桌面端 Jupyter 的区别：
| 特性 | 桌面 Jupyter | QNotebook |
|---|---|---|
| 运行方式 | Python 进程 + 本地 HTTP 服务 | QPython 内置运行时 |
| 界面 | 完整浏览器界面 | 移动优化的浏览器视图 |
| Kernel 切换 | 支持多语言 Kernel | 主要是 Python |
| Markdown 渲染 | 完整支持 | 基础支持 |
| 图表显示 | matplotlib 直接渲染 | 支持图片输出 |
打开 Notebook 的方式
方式一：QPython 主界面入口
QPython 主界面底部或扩展区域通常有 QNotebook 的入口按钮，点击后进入 Notebook 浏览器视图，可以浏览手机上的 .ipynb 文件并打开。
方式二：从 QEditor 打开
部分版本的 QEditor 可以识别 .ipynb 文件格式，或者通过文件浏览器找到 .ipynb 文件后选择用 QNotebook 打开。
方式三：从文件管理器打开
手机上的 .ipynb 文件可以通过 QNotebook App 关联，在系统文件管理器里直接点击打开。
Notebook 文件的存储位置
新建的 Notebook 文件默认保存到 notebook/ 目录（路径通常是 /Android/data/org.qpython.qpy/files/notebook/）。可以在保存对话框里选其他位置。
和 QEditor / REPL 的关系
QNotebook、QEditor、REPL 终端三者是互补关系：
| 工具 | 适合场景 |
|---|---|
| REPL 终端 | 临时验证一两行代码、快速探索 |
| QEditor | 完整的 .py 脚本开发、多文件项目 |
| QNotebook | 需要混合代码 + 文字说明 + 图表展示的场景（学习笔记、数据分析演示） |
你可以在三者之间自由切换——比如在 REPL 里验证了一段数据处理代码，确认没问题后把它放进 QNotebook 配合 Markdown 说明整理成教程。
小结
QNotebook 让 Jupyter 的工作流在手机上变成可能。对于数据分析学习者、AI 应用原型开发、学习笔记整理等场景，Notebook 格式比纯 .py 文件更适合。它在移动端的功能有裁剪，但核心体验——代码+文字+图表混排、Cell 独立执行——都保留了。
接下来看 Cell 执行 了解 Notebook 的核心操作方式。