IntelliJ IDEA 2025.1 Help

创建和编辑 Jupyter 笔记本

设置您的项目

  1. 在 IntelliJ IDEA 中,创建一个新的 Python 项目

  2. 为选定的解释器 安装jupyter 包。

  3. 当所有索引过程完成后,您就可以开始处理 notebook 文件了。

创建并打开 Jupyter 笔记本

要打开现有的 .ipynb 文件,请按照与其他类型文件相同的步骤操作。 如有需要,您可以创建一个 notebook 文件。

创建一个 notebook 文件

  1. 请执行以下操作之一:

    • 项目 工具窗口中右键点击目标目录,并从上下文菜单中选择 新建

    • 请按 Alt+Insert

  2. 请选择 Jupyter Notebook

  3. 在打开的对话框中,输入文件名。

笔记本文件具有 *.ipynb 扩展名,并标有相应的图标 Jupyter

将 Python 文件转换为 Jupyter notebook

  1. 项目 工具窗口中右键点击该文件。

  2. 选择 转换为 Jupyter Notebook  从上下文菜单。

将 Jupyter notebook 转换为 Python 文件

  1. 项目 工具窗口中右键点击该文件。

  2. 选择 转换为 Python 文件  从上下文菜单。

导出 Jupyter notebooks

您可以将 Jupyter 笔记本导出为多种格式:

  1. 在“项目”工具窗口中右键点击 Jupyter notebook 文件。

  2. 选择 将 Notebook 导出为 ,然后从列表中选择格式。

    导出 Jupyter notebook 文件

编辑 Jupyter notebooks

您可以对一个单元或整个笔记本应用各种编辑操作。 按 Ctrl+A 一次以选择文本光标处的单元格,再按 Ctrl+A 两次以选择笔记本中的所有单元格。

Jupyter 笔记本的编辑器有两种模式: edit modecommand mode。 根据模式,您可以在笔记本单元格中编辑代码,也可以使用键盘快捷键对单元格执行特定操作。

编辑模式

  • 要切换编辑模式,请按 Enter 或点击任意单元格。

  • 当单元格处于编辑模式时,它在单元格内有一条带文本光标的高亮线。

    编辑模式中的单元格
  • 在编辑模式下,您可以使用 UpDown 键逐行浏览所有单元格。

命令模式

  • 若要切换命令模式,请按 Escape 或点击装订区域。

  • 在命令模式中,您可以使用 UpDown 键逐个导航笔记本单元格,并使用键盘快捷键 选择复制粘贴删除单元格。

编辑单元格

  • 新建的笔记本包含一个代码单元格。 您可以在笔记本工具栏中的单元格类型选择器更改其类型:

    选择单元格类型
  • 要编辑代码单元,只需点击它。

  • 要编辑 Markdown 单元格,请双击它或按 Enter 并开始输入。 要预览输出,请按 Shift+Enter

Markdown 单元格工具栏

  1. 在 Markdown 单元格中选择文本部分后,工具栏会出现。

    Markdown 单元格工具栏
  2. 您可以使用它应用以下格式选项:

    条目

    图标

    快捷键

    描述

    文本样式

    点击下拉菜单以将文本格式更改为各种标题级别。

    加粗文本

    加粗文本

    Ctrl+B

    将选定的文本加粗(**text**)。

    斜体文本

    斜体文本

    Ctrl+I

    将选定的文本设置为斜体(_text_)。

    删除线

    删除线

    Ctrl+I

    将选定的文本加上删除线。 (~~text~~).

    代码

    代码

    Ctrl+Shift+C

    将文本格式化为内联代码。

    创建链接

    创建链接

    Ctrl+Shift+U

    添加一个超链接。

    无序列表

    无序列表

    创建一个无序列表。

使用笔记本单元格

添加单元格

  • 要在选定的单元格上方添加代码单元格,请执行以下操作之一:

  • 要在选定单元格下方添加一个代码单元格,请执行以下操作之一:

    • 编辑模式下,按 Alt+Shift+B

    • 命令模式 ,按 B

    • 从笔记本工具栏中选择 下方代码单元

    添加一个笔记本单元格
  • 使用单元之间的弹出窗口添加 code切换到 Markdown 模式 (${ hints.mdMode })AI 单元到您的笔记本:

    Jupyter notebook 单元格之间的弹出窗口

选择单元格

  • 要选择一个单元格,请点击该单元格旁边的标尺。

  • 要选择多个单元格:

    • 点击紧靠单元格旁边的装订区域,同时按住 Shift 选择连续的单元格,或按住 Ctrl 选择非连续的单元格。

    • 在命令模式下,按住 Shift 并按 UpDown 键。

您可以 执行复制合并展开删除选定的单元格。

拖放单元格

要重新排列笔记本单元格:

  1. 点击并按住单元格旁边边距中的拖动图标

  2. 将单元格拖动到所需位置,然后释放鼠标按钮以将其放置在高亮区域中。

拖动单元格

复制粘贴单元格

  • 要在 命令模式下复制单元格,请按 Ctrl+CC ,或点击笔记本工具栏上的 复制单元格

  • 要粘贴复制的单元格,请按 Ctrl+VV 或点击 请粘贴以下单元格

  • 要将其粘贴到当前单元格上方,请按 Shift 并使用 Ctrl+V/Shift+V

  • 您还可以从单元格的上下文菜单中选择所需的操作。

拆分和合并单元格

  • 要将当前单元格与下面的单元格合并,请右键点击该单元格,并从上下文菜单中选择 合并下面的单元格 命令。

    同样,您可以使用相应的命令将一个单元格与所选单元格上方的单元格合并。

  • 要合并多个单元格,请 选择它们,然后从主菜单中选择 单元格 | 合并所选单元

    或者,您可以使用 Find Action来运行 合并所选单元 命令。

  • 要将一个单元格拆分为两个单元格,请将文本光标放置在要分割的位置,然后右键点击,并从上下文菜单中选择 拆分单元

展开和折叠单元格

  • 点击边框以展开或折叠笔记本单元。

    扩展的笔记本单元
    折叠的笔记本单元格

删除单元格

  • 点击 删除单元删除单元笔记本工具栏

  • 右键点击单元格并从上下文菜单中选择 删除单元

添加单元格标签

您可以在笔记本编辑器中为每个单元分配和查看标签:

  1. 右键点击该单元格。

  2. 选择 添加单元标记  从上下文菜单。

    已添加单元格标签
  3. 输入标签并点击 确认

要移除标签,请右键点击并选择 移除标签

使用编码辅助

您可以借助 Python 代码洞察(如语法高亮和代码补全)编辑代码单元。

  • IntelliJ IDEA 为类、函数和变量的名称启用 代码补全。 开始输入代码结构的名称,建议列表将会出现。

    函数补全
    类变量补全
    路径补全
    包装完成
    DataFrame 列名补完
  • 意图操作和快速修复. 您可以使用意图操作 添加缺失的导入

    缺少导入的快速修复

    请注意,您可以将 import 声明添加到当前单元格或笔记本的第一个单元格。

自定义配色方案

您可以根据自己的偏好和习惯配置支持 Notebooks 的语法高亮。

  1. 设置 对话框(Ctrl+Alt+S )中,前往 编辑器 | 配色方案 | 笔记本

  2. 选择配色方案,接受从默认值继承的高亮设置,或按照 颜色和字体 中所述自定义它们。

    最后修改日期: 2025年 4月 24日