跳转到主要内容
OpenIDEA 用笔记本编辑器打开 .ipynb 文件。你可以编辑代码单元格和 Markdown 单元格,在 IDE 自动启动的 Python 内核上运行,并把结果保存回原文件。

前提条件

  • 一个装好 ipykernel 的 Python 解释器(pip install ipykernel)。OpenIDEA 不会替你安装任何包;缺少 ipykernel 时,编辑器会提示“请在所选 Python 环境中安装 ipykernel,然后重启内核”。
  • 项目已受信任。项目处于受限模式时无法运行单元格。
  • 笔记本格式为 nbformat 4。其他版本会被拒绝打开,文件不会被改动。

打开笔记本

从项目工具窗口、转到文件或命令行打开任意 .ipynb 文件,它会以笔记本编辑器打开,而不是原始 JSON。 编辑器顶部工具栏:

选择 Python 解释器

下拉框里列出 OpenIDEA 检测到的 Python 环境,以及项目解释器。如果不手动选择,笔记本会使用项目的 Python 解释器;没有配置时使用检测到的第一个环境。 选择结果按笔记本分别记住。只能在没有单元格运行时切换。
使用虚拟环境时,请选择环境自己的 python(例如 .venv/bin/python)。OpenIDEA 不会把符号链接解析成基础解释器,所以内核就运行在这个环境里。
每个打开的笔记本各有一个内核进程,关闭笔记本时内核随之关闭。

编辑单元格

每个单元格都有一个小工具栏:
  • 单元格类型下拉框:代码、Markdown 或 原始内容。
  • 代码单元格有 运行单元格;Markdown 单元格有 编辑 Markdown / 预览 Markdown。双击已渲染的 Markdown 单元格也可以进入编辑。
  • 上移单元格、下移单元格、在下方插入代码单元格、删除单元格。
笔记本末尾的 添加代码单元格 和 添加 Markdown 单元格 用于在最后追加单元格。 代码单元格的工具栏旁显示执行序号(如 [3])。原始单元格和 OpenIDEA 不认识的单元格类型以只读方式显示,内容原样保留。

快捷键

这些按键由笔记本编辑器直接处理,不在键位映射设置里。

输出

和 Jupyter 一样,输出会在保存时写入笔记本文件。

限制

  • 只支持 Python 内核,不支持其他语言的内核,也不能连接远程 Jupyter 服务器。
  • 交互式组件(ipywidgets)和 JavaScript 输出不会运行。
  • 单元格运行期间不能撤销或重做。