# Jupyter notebook 支持

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

> **Warning:**
> 以下内容仅在 Python 和 Jupyter 插件 [已安装并启用](managing-plugins.html)时有效！

借助在 IntelliJ IDEA 中通过 [Python](https://plugins.jetbrains.com/plugin/631-python) 和 [Jupyter](https://plugins.jetbrains.com/plugin/22814-jupyter) 插件提供的 Jupyter Notebook 集成，您可以编辑、执行并调试 Notebook 源代码，并查看执行结果，包括流数据、图像和其他媒体。

IntelliJ IDEA 中的 Notebook 支持包括：

* 编码辅助： * 错误和语法 [高亮显示](code-inspection.html)。 * [代码补全](auto-completing-code.html)。 * 能够创建 [行注释](working-with-source-code.html) `Ctrl+/` (Windows), `⌘ /` (macOS), `⌘ /` (IntelliJ IDEA Classic (macOS)), `⌘ /` (macOS System Shortcuts), `Ctrl+/` (XWin), `Ctrl+/` (GNOME), `Ctrl+/` (KDE), `Alt+;` (Emacs), `Ctrl+/` (Sublime Text), `⌘ /` (Sublime Text (macOS)), `Ctrl+Alt+/` (Visual Studio), `⌘ ⌥ /` (Visual Studio (macOS)), `Ctrl+/` (NetBeans), `Ctrl+/` (Eclipse), `⌘ /` (Eclipse (macOS))。

* 在 [IPython](http://ipython.org/ipython-doc/stable/overview.html)命令在 [Python 控制台](console-python-console.html)中执行的能力。

* 专用 [Jupyter Notebook Debugger](running-jupyter-notebook-cells.html#debug-notebook)。

* Jupyter 笔记本基本操作的快捷键。

* 识别 `.ipynb` 文件并用 ![Jupyter 图标](https://resources.jetbrains.com/help/img/idea/2026.3/python-jupyter.icons.org.jetbrains.plugins.notebooks.jupyter.expui.jupyterNotebook.svg) 图标标记它们的能力。

* Jupyter 特有的 [AI功能](https://www.jetbrains.com/zh-cn/help/ai-assistant/ai-in-jupyter-notebooks.html)。

## 快速开始

要开始使用 IntelliJ IDEA 中的 Jupyter notebooks：

Procedure:

1. [创建一个新的 Python 项目](creating-empty-python-project.html)，指定一个 [Python 解释器](configuring-python-sdk.html)，并安装   Jupyter   包。

2. 打开或 [创建](editing-jupyter-notebook-files.html#create-notebook-file)一个  `.ipynb` 文件。

3. [添加和编辑](editing-jupyter-notebook-files.html) 源代码单元格。

4. [执行](running-jupyter-notebook-cells.html#execute-cell)任意代码单元以启动 Jupyter 服务器。

## 熟悉用户界面

### Jupyter notebook 工具栏

Jupyter Notebook   工具栏可快速访问 Notebook 的所有基本操作。

可以通过添加、移除和重新排列操作来自定义工具栏：

1.  点击 Notebook 工具栏上的 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.actions.more.svg)   更多  。

2.  请执行以下操作之一：

* 选择 自定义工具栏 ，然后从列表中选择操作。 将添加到工具栏。

* 选择 `自定义工具栏 | 自定义 Jupyter 工具栏……` 以打开可添加或移除其他操作的对话框。 更多信息请参阅 [菜单和工具栏](customize-actions-menus-and-toolbars.html)。

|  条目  |  描述  |
| --- | --- |
|  ![在下方插入代码单元格](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)    在下方插入代码单元格     |  在选定的单元下添加一个代码单元。  |
|  ![上移单元格](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.up.svg)    上移单元格     |  上移当前单元格。  |
|  ![下移单元格](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.down.svg)    下移单元格     |  下移当前单元格。  |
|  ![运行单元格并选择下方](https://resources.jetbrains.com/help/img/idea/2026.3/python-jupyter.icons.com.jetbrains.python.jupyter.expui.runAndSelect.svg)    运行单元格并选择下方     |  执行此单元并选择下方的单元。 如果下面没有单元格，IntelliJ IDEA 将会创建它。  |
|  ![全部运行](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.runAll.svg)    全部运行     |  执行笔记本中的所有单元格。  |
|  ![重启内核](https://resources.jetbrains.com/help/img/idea/2026.3/python-jupyter.icons.com.jetbrains.python.jupyter.expui.restartKernel.svg)    重启内核     |  点击此图标以 [重新启动当前正在运行的 kernel](configuring-jupyter-notebook.html#restart-kernel)。  |
|  ![清除所有输出](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.clearCash.svg)    清除所有输出     |  清除笔记本中的所有输出。  |
|  ![创建 Gist](https://resources.jetbrains.com/help/img/idea/2026.3/app.vcs.vendors.github.svg)    创建 Gist     |  打开 [创建 Gist](share-code-with-gists.html#create_gist) 对话框。  |
|  ![转到单元格](https://resources.jetbrains.com/help/img/idea/2026.3/py_jupyter_go_to.png)  |  点击此微件以导航到最后执行的单元格。  |
|  ![配置 Jupyter 服务器](https://resources.jetbrains.com/help/img/idea/2026.3/py_jupyter_servers.png)  |  显示当前使用的 Jupyter 服务器。 点击此微件并选择  `配置 Jupyter 服务器`  以 [设置](configuring-jupyter-notebook.html#setup-managed-server)另一个本地或远程 Jupyter 服务器。  |
|  ![打开 Jupyter 控制台](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.fileTypes.shell.svg)    打开 Jupyter 控制台     |  打开   Jupyter 控制台  选项卡的 [Jupyter 工具窗口](#jupyter-tool-window)。 为当前 Notebook 启动 Jupyter 服务器后，此按钮会启用。  |
|  其他操作  |
|  ![单元格类型](https://resources.jetbrains.com/help/img/idea/2026.3/py_jupyter_cell_type.png)    单元类型选择器     |  显示所选单元格的类型。 点击以选择其他类型并相应转换单元格。  |
|  ![删除单元格](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.delete.svg)    删除单元格     |  删除当前单元格。  |
|  ![调试单元](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.debug.svg)    调试单元     |  为选中的单元格启动调试。  |
|  ![选择上方单元格](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.findAndShowPrevMatches.svg)    选择上方单元格     |  选择上方的单元格。  |
|  ![选择下一个单元格](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.findAndShowNextMatches.svg)    选择下一个单元格     |  选择下方的单元格。  |
|  ![在浏览器中打开 Notebook](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.codeInsight.inlayGlobe.svg)    在浏览器中打开 Notebook     |  在浏览器中打开当前的 notebook。  |

> **Note:**
> 要快速访问 [Jupyter 常规](jupyter.html) 设置页面，请在 Notebook 工具栏上单击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.actions.more.svg)   更多  ，然后选择 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.settings.svg)   打开 Jupyter 设置……  。

### 单元

单元格包含一段代码或 Markdown 文本。 当您运行代码单元时，您可以查看单元输出，这是代码执行的结果：

![代码单元格](https://resources.jetbrains.com/help/img/idea/2026.3/py_codecell.png)

每个单元格都包含自己的工具栏，可快速访问基本操作。 默认情况下，当鼠标悬停在单元格上时会显示。

![单元格工具栏](https://resources.jetbrains.com/help/img/idea/2026.3/py_cell_toolbar.png)

还可以使所选单元格的工具栏始终显示。 为此，请转到  `设置 | Jupyter | Jupyter 常规`  并启用   为所选单元显示工具栏   选项。

对于较长的单元格，滚动时可以使工具栏在编辑器右上角保持可见。 为此，请转到  `设置 | Jupyter | Jupyter 常规`  并选中   单元工具栏粘性   复选框。

![单元格工具栏设置](https://resources.jetbrains.com/help/img/idea/2026.3/py_cell_toolbar_settings.png)

单元格工具栏由以下元素组成：

* 工具栏上直接可用的操作 .

* 上下文菜单中的其他操作 . 要打开上下文菜单，请点击单元工具栏上的 ![更多](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.actions.more.svg)。

工具栏和上下文菜单中可用的操作会因单元格类型而异：

代码单元工具栏:

|  条目  |  描述  |
| --- | --- |
|  工具栏操作  |
|  ![AI 编辑单元格](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.ml.llm.core.icons.aiAssistantColored.svg)AI 编辑单元格  |  获取 AI 辅助以获得代码建议或改进。  |
|  ![调试单元](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.run.debug.svg) 调试单元格  |  调试单元格中的代码。  |
|  ![删除单元格](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.delete.svg) 删除单元格  |  移除当前单元格。  |
|  上下文菜单选项  |
|  运行上方单元格  |  运行当前单元格上方的单元格。  |
|  运行当前单元格及下方单元格  |  运行当前单元格及其下方的单元格。  |
|  上移单元格  |  上移当前单元格。  |
|  下移单元格  |  下移当前单元格。  |
|  合并上方单元  |  将当前单元格与上方单元格合并。  |
|  合并下面的单元格  |  将当前单元格与下方单元格合并。  |
|  拆分单元格  |  在文本光标位置将单元格拆分为两个。  |
|  在下方复制单元格  |  复制当前单元格并在下方插入副本。  |
|  复制单元格  |  复制该单元格并将其添加到剪贴板。  |
|  剪切单元格  |  移除该单元格并将其添加到剪贴板。  |
|  将单元转换为 Markdown  |  将当前单元格的类型更改为 Markdown。  |
|  将单元格转换为 SQL  |  将当前单元格的类型更改为 SQL。  |
|  添加单元格标记  |  添加标记以组织或管理单元格。  |
|  清除输出},{  |  清除单元格输出。  |

Markdown 单元格工具栏:

|  条目  |  描述  |
| --- | --- |
|  工具栏操作  |
|  ![AI 编辑单元格](https://resources.jetbrains.com/help/img/idea/2026.3/intellij.ml.llm.core.icons.aiAssistantColored.svg)AI 编辑单元格  |  获取 AI 辅助以获得代码建议或改进。  |
|  ![编辑](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.edit.svg) 编辑  |  切换到 [编辑模式](editing-jupyter-notebook-files.html#edit-mode)。  |
|  ![运行部分](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg) 运行节  |  执行 Markdown 节内的所有单元格。  |
|  ![删除单元格](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.delete.svg) 删除单元格  |  移除当前单元格。  |
|  上下文菜单选项  |
|  添加单元格标记  |  添加标记以组织或管理单元格。  |
|  在下方复制单元格  |  复制当前单元格并在下方插入副本。  |
|  上移单元格  |  上移当前单元格。  |
|  下移单元格  |  将当前单元格下移一位。  |
|  复制单元格  |  复制该单元格并将其添加到剪贴板。  |
|  剪切单元格  |  移除该单元格并将其添加到剪贴板。  |

Procedure: 自定义单元格工具栏

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `外观 & 行为 | 菜单和工具栏` 。

或者，点击工具栏上的 ![更多](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.moreVertical.svg) 并选择   自定义单元工具栏  。

2. 在   自定义 Jupyter 单元工具栏   下添加或移除操作。

有关更多信息，请参见 [菜单和工具栏](customize-actions-menus-and-toolbars.html)。

3. 点击   OK   应用更改并关闭窗口，或点击   应用   保持窗口打开。

### Jupyter 工具窗口

Jupyter   工具窗口会在任意 Jupyter 服务器 [启动](configuring-jupyter-notebook.html#run-notebook)后显示。 此窗口的   服务器   选项卡显示 Jupyter 服务器的当前状态以及浏览器中 Notebook 的链接。

![Jupyter 服务器工具窗口：服务器日志选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/py_jupyter_tool_window.png)

它还提供了控制来停止正在运行的服务器（ ![停止服务器](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.stop.svg)）并启动已停止的服务器（ ![运行服务器](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg)）。

### Jupyter 控制台

可以在   Jupyter 控制台   中执行命令：

Procedure:

1. 在 [Notebook 工具栏](#toolbar)上点击 ![打开 Jupyter 控制台](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.fileTypes.shell.svg)   打开 Jupyter 控制台  。 为当前 Notebook 启动 Jupyter 服务器后，此按钮会启用。 您可以为每个 notebook 文件打开一个控制台。

2. 输入一条命令或一系列命令，然后按控制台工具栏上的 ![在单行控制台中执行当前语句](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.gutter.run.svg)。

变量   选项卡提供有关已执行单元格的变量值的详细报告。 启动 Jupyter 控制台时，该选项卡会自动打开。

![Jupyter 工具窗口：变量选项卡](https://resources.jetbrains.com/help/img/idea/2026.3/py_jupyter_variable_view.png)

### Jupyter Variables 工具窗口

每次执行单元时，都会显示   Jupyter 变量   工具窗口。 如果需要永久隐藏它，请转到  `设置 | Jupyter | Jupyter 常规`  并取消选中   执行时显示“变量”工具窗口   复选框。

![Jupyter Variables 工具窗口](https://resources.jetbrains.com/help/img/idea/2026.3/py_jupyter_variables_tool_window.png)

Procedure:

在   Jupyter 变量   工具窗口中，您可以查看变量值并管理变量列表：

* 点击 ![刷新变量](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.refresh.svg)   刷新变量  ，无需重新运行代码单元格即可刷新变量列表。

![刷新变量](https://resources.jetbrains.com/help/img/idea/2026.3/py_jupyter_variables_tool_window_refresh.png)

* 要按名称或类型对变量进行排序，请点击 ![排序方式](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.objectBrowser.sortAlphabetically.svg)   排序方式  ，然后从列表中选择所需选项

![排序方式](https://resources.jetbrains.com/help/img/idea/2026.3/py_jupyter_variables_tool_window_sort.png)

## See also

### 外部链接

[Notebook support](http://nbviewer.ipython.org/github/ipython/ipython/blob/2.x/examples/Notebook/Index.ipynb) [Jupyter Hub](https://jupyterhub.readthedocs.io/en/latest/) [Running a notebook server](http://jupyter-notebook.readthedocs.io/en/latest/public_server.html)