Jupyter notebook 支持
在 PyCharm 中提供的 Jupyter Notebook 集成功能，您可以编辑、执行和调试 notebook 源代码，并检查执行输出，包括流数据、图像和其他媒体。
PyCharm 中的 Notebook 支持包括：
代码辅助：
在 IPython命令在 Python 控制台中执行的能力。
Jupyter 笔记本基本操作的快捷键。
识别 .ipynb 文件并用
图标标记它们的能力。Jupyter 项目模板。
Jupyter 特有的 AI功能。
在开始之前
为了确保 Jupyter Notebook 的所有功能正常工作，请在 已安装 选项卡的 设置 | 插件 页面上启用 Markdown 插件。 有关更多信息，请参阅 管理插件。
快速开始
要开始使用 PyCharm 中的 Jupyter notebooks：
创建一个 Jupyter 项目。
打开或 创建一个 .ipynb 文件。
添加和编辑 源代码单元格。
执行任意代码单元以启动 Jupyter 服务器。
熟悉用户界面
Jupyter notebook 工具栏
Jupyter 笔记本 工具栏提供对所有笔记本基本操作的快速访问。
您可以通过添加、移除和重新排列操作来自定义工具栏：
在笔记本工具栏中点击
更多。请执行以下操作之一：
选择 自定义工具栏 ，然后从列表中选择操作。 它将被添加到工具栏。
选择 打开对话框，您可以在其中添加或移除附加操作。 有关更多信息，请参阅 菜单和工具栏。
项目 | 描述 |
|---|---|
下方代码单元格 | 在选定的单元下添加一个代码单元。 |
上移单元格 | 上移当前单元格。 |
下移单元格 | 下移当前单元格。 |
运行单元格并选择下一个 | 执行此单元并选择下方的单元。 如果下面没有单元格，PyCharm 将会创建它。 |
运行所有 | 执行笔记本中的所有单元格。 |
重启内核 | 点击此图标以 重新启动当前正在运行的 kernel。 |
清除所有输出 | 清除笔记本中的所有输出。 |
创建 Gist | 打开 Create Gist 对话框。 |
| 点击此小部件以导航到最后执行的单元格。 |
| 显示当前使用的 Jupyter 服务器。 点击此小部件并选择 以 设置另一个本地或远程 Jupyter 服务器。 |
打开 Jupyter Console | 打开 Jupyter 控制台 选项卡的 Jupyter 工具窗口。 当您为当前 notebook 启动了 Jupyter 服务器时，此按钮将启用。 |
其他操作 | |
单元类型选择器 | 显示所选单元的类型。 点击以选择不同类型并相应转换单元。 |
删除单元格 | 删除当前单元格。 |
调试单元格 | 为选中的单元格启动调试。 |
选择上方单元格 | 选择上方的单元格。 |
选择下一个单元格 | 选择下方的单元格。 |
在浏览器中打开 Notebook | 在浏览器中打开当前的 notebook。 |
单元格
单元格包含一段代码或 Markdown 文本。 当您运行代码单元时，您可以查看单元输出，这是代码执行的结果：
每个单元都包含其自己的工具栏，可快速访问基本操作。
单元工具栏由以下元素组成：
工具栏上直接可用的操作。
上下文菜单中的其他操作。 要打开上下文菜单，请点击单元工具栏上的
。
工具栏和上下文菜单中可用的操作因单元类型而异：
项目 | 描述 |
|---|---|
工具栏操作 | |
| 获取 AI 帮助以提供代码建议或改进。 |
| 调试单元中的代码。 |
| 移除当前单元。 |
上下文菜单选项 | |
运行以上单元 | 运行当前单元上方的所有单元。 |
运行当前单元及其下方单元 | 运行当前单元及其下方的所有单元。 |
上移单元格 | 将当前单元上移。 |
下移单元格 | 下移当前单元. |
合并上方单元 | 将当前单元与上方单元合并。 |
合并下面的单元格 | 将当前单元与下方单元合并。 |
拆分单元格 | 在插入符位置将一个单元拆分为两个单元。 |
在下方复制当前单元 | 复制当前单元并将副本插入到下方。 |
复制单元格 | 复制单元并将其添加到剪贴板。 |
剪切单元格 | 移除单元并将其添加到剪贴板。 |
将单元格转换为 Markdown | 将当前单元的类型更改为 Markdown。 |
将单元格转换为 SQL | 将当前单元的类型更改为 SQL。 |
添加单元格标签 | 添加标签以组织或管理单元。 |
清除输出 | 清除单元的输出。 |
AI 编辑单元项目 | 描述 |
|---|---|
工具栏操作 | |
| 获取 AI 帮助以提供代码建议或改进。 |
| 切换到 编辑模式。 |
| 执行 Markdown 部分中的所有单元。 |
| 移除当前单元。 |
上下文菜单选项 | |
添加单元格标签 | 添加标签以组织或管理单元。 |
在下方复制当前单元 | 复制当前单元并将副本插入到下方。 |
上移单元格 | 将当前单元上移。 |
下移单元格 | 将当前单元下移一行。 |
复制单元格 | 复制单元并将其添加到剪贴板。 |
剪切单元格 | 移除单元并将其添加到剪贴板。 |
编辑项目 | 描述 |
|---|---|
工具栏操作 | |
| 获取 AI 帮助以提供代码建议或改进。 |
| 调试单元中的代码。 |
| 移除当前单元。 |
上下文菜单选项 | |
运行以上单元 | 运行当前单元上方的所有单元。 |
运行当前单元及其下方单元 | 运行当前单元及其下方的所有单元。 |
上移单元格 | 将当前单元上移。 |
下移单元格 | 下移当前单元. |
合并上方单元 | 将当前单元与上方单元合并。 |
合并下面的单元格 | 将当前单元与下方单元合并。 |
拆分单元格 | 在插入符位置将一个单元拆分为两个单元。 |
在下方复制当前单元 | 复制当前单元并将副本插入到下方。 |
复制单元格 | 复制单元并将其添加到剪贴板。 |
剪切单元格 | 移除单元并将其添加到剪贴板。 |
将单元格转换为 Markdown | 将当前单元的类型更改为 Markdown。 |
添加单元格标签 | 添加标签以组织或管理单元。 |
清除输出 | 清除单元的输出。 |
自定义单元工具栏
按下 Ctrl+Alt+S 打开设置，然后选择 。
或者，点击
工具栏，然后选择 自定义单元工具栏。在 自定义 Jupyter 单元工具栏 下添加或删除操作。
欲了解更多信息，请参阅 菜单和工具栏。
点击 确定 应用更改并关闭窗口，或点击 应用 保持窗口打开。
Jupyter 工具窗口
当某个 Jupyter 服务器 launched 启动后，会出现 Jupyter 工具窗口。 此窗口的 服务器 选项卡显示 Jupyter 服务器的当前状态以及指向浏览器中 notebook 的链接。
它还提供了控制来停止正在运行的服务器（
）并启动已停止的服务器（
）。
Jupyter 控制台
您可以在 Jupyter 控制台 中执行命令：
点击
打开 Jupyter Console 位于 notebook 工具栏上。 当您为当前 notebook 启动了 Jupyter 服务器时，此按钮将启用。 您可以为每个 notebook 文件打开一个控制台。输入一条或多条命令，然后按
位于控制台工具栏上。
变量 选项卡提供有关已执行单元变量值的详细报告。 当您启动 Jupyter 控制台时，该选项卡会自动打开。
Jupyter Variables 工具窗口
每次执行单元格时， Jupyter 变量 工具窗口都会出现。 如果需要永久隐藏它，请转到 并取消选中 执行时显示变量工具窗口 复选框。
结构工具窗口
对于 .ipynb 文件， Markdown 和 Python 单元都可以显示在 Structure tool window 中：
Markdown单元使用其标题文本作为标签进行展示。 仅包含标题的Markdown单元会包含在 结构视图 中。要在 结构工具窗口 中显示
Python单元，请转到 并启用 在结构视图中显示 Python 单元格 复选框。 启用后，您可以选择下列选项之一：All ：显示所有代码单元。
已注释 ：仅显示以注释开头的代码单元。 该注释将作为单元标签使用。
