Jupyter 笔记本支持

您可以使用笔记本工具栏和单元格工具栏上的图标、代码单元格上下文菜单的命令(右键单击代码单元格将其打开)以及主菜单的运行命令,以多种方式执行笔记本单元格的代码. 请注意,当您使用本地笔记本时,您不需要提前启动任何 Jupyter 服务器:只需执行任何单元,服务器就会启动。

运行代码单元

  • 使用以下智能快捷方式快速运行代码单元:

    • Ctrl+Enter:运行当前单元格。

    • Shift+Enter:运行当前单元格并选择其下方的单元格。

    一次执行一个单元格时,请注意代码依赖性。如果一个单元格依赖于另一个单元格中的某些代码,则应首先执行该单元格。

    如果出现任何错误,请展开Traceback节点以预览完整的错误消息。

  • 要执行笔记本中的所有代码单元,请单击全部运行笔记本工具栏或按Ctrl + Shift + Alt + Enter

当您停止服务器更改服务器或内核时,您必须再次执行所有具有依赖关系的单元,因为执行结果仅对当前服务器会话有效。

查看变量

  • 执行 notebook 时,可以在Jupyter工具窗口的Variables选项卡中预览变量。

    Jupyter 服务器工具窗口:变量选项卡

    默认情况下,变量是异步加载的。要更改加载策略,请单击管理加载策略变量选项卡,选择变量加载策略,然后选择一种可用模式。有关更多详细信息,请参阅管理变量加载策略

    您可以单击变量右侧的链接以表格形式预览其值。

    除了在变量选项卡中预览变量的值外,您还可以在编辑器中查看变量使用的值。请注意,未显示变量分配。

    要启用此选项,请在项目设置/首选项 |中选择在编辑器中显示内联值。木星

    源代码编辑器中的内联变量

执行单元格后,其输出将显示在代码下方。您可以保存结果或清除输出。

过程输出

  • 如果您的笔记本单元格包含任何绘制图表的代码,您可以将图表另存为图像:右键单击输出并从上下文菜单中选择另存为。

    您可以反转绘制的图像以获得更好的可读性。在项目 Settings/Preferences ( ) 的Jupyter页面上选中Invert images in dark theme复选框,然后重新启动编辑器以应用更改。Ctrl+Alt+S

  • 构建任何数据框后,您可以以表格形式预览它们。要在编辑器选项卡中打开数据框,请右键单击单元格输出并选择在新选项卡菜单项中打开。

    复制表格单元格

    您可以复制选定的片段或表格的所有单元格。要将输出保存为*.csv格式,请从上下文菜单中选择另存为菜单项并指定文件名。默认情况下,表格保存在output.csv中。

    您可以通过单击列标题对列中的数据进行排序。您还可以将表的列标题或所有标题复制到剪贴板。只需右键单击任何表头以获取上下文菜单并选择目标命令。

    复制表格标题
  • 您可以通过展开和折叠单元格输出来管理笔记本的长度。单击单元格计数器附近的箭头以展开或折叠单元格输出。

    展开和折叠单元格输出

使用 PyCharm,您始终可以快速预览特定变量、类型或参数的参考文档。

预览参考文档

  1. 要查看特定代码单元的任何元素的参考信息,请将插入符号放在目标代码单元中并键入? <type/variable/argument>。(在本例中,您将预览 的文档plt.scatter)。请注意,代码元素应可在代码单元中访问。

  2. 执行单元格Introspection选项卡在Jupyter工具窗口中打开。

    预览 plt.scatter 的参考文档
  3. 在Introspection选项卡中预览参考文档。

请注意,Introspection选项卡显示了最新请求的代码元素的文档。即使您继续执行其他代码单元、重新启动服务器或删除您的请求行,也会显示此信息。

PyCharm 提供了全功能的 Jupyter Notebook 调试器。

在 Jupyter 笔记本中调试代码

  1. 在选定的单元格中设置断点 Alt + Shift + Enter ,然后按Windows 或⌥⇧↩macOS。或者,您可以右键单击单元格并从上下文菜单中选择调试单元格。

    Jupyter Notebook Debugger工具窗口打开。

    Jupyter Notebook Debugger 工具窗口
  2. 使用步进工具栏按钮 步进工具栏选择您想在下一个停止的行并切换到调试器选项卡以预览变量值:

    跳过 Jupyter Notebook 调试器

    调试在单个代码单元中执行。但是,如果您的代码单元从任何已调试的单元调用函数,您可以单步执行。相关的断点也将起作用。请注意,必须调试具有该功能的单元格,而不仅仅是执行。

    同样,您可以单步执行从位于同一项目中的 Python 文件调用的函数。

  3. 继续调试步骤以完成单元格的执行。

    调试完成

步进动作

物品

工具提示和快捷方式

描述

调试器工具栏上可用的操作。

跨过去

跨过

F8

单击此按钮执行程序,直到当前方法或文件中的下一行,跳过当前执行点引用的方法(如果有)。如果当前行是方法中的最后一行,则执行到该方法之后执行的行。

踏入

踏入

F7

单击此按钮可使调试器单步执行在当前执行点调用的方法。

走出去

走出去

Shift+F8

单击此按钮可使调试器跳出当前方法,跳到紧随其后执行的行。

更多踩踏动作通过单击Debugger 工具栏可获得其他步进操作。

强制跨步

强制跨步

跳过当前代码行并带您到下一行,即使突出显示的行中有方法调用。如果被调用的方法中有断点,它们将被忽略。

智能步入

智能步入

当一行中有多个方法调用,并且您想明确输入哪个方法时,智能单步进入很有帮助。此功能允许您选择您感兴趣的方法调用。

运行到光标

运行到光标

Alt+F9

单击此按钮可恢复程序执行并暂停,直到执行点到达编辑器中当前光标位置的行。不需要断点。实际上,在插入符号处为当前行设置了一个临时断点,一旦程序执行暂停,该断点就会被删除。因此,如果插入符号位于已经执行的行,程序将继续执行以进一步执行,因为没有办法回滚到先前的断点。当您深入了解方法序列并需要一次退出多个方法时,此操作特别有用。

如果在将您带到指定行之前应该执行的行设置了断点,则调试器将在第一个遇到的断点处暂停。

强制运行到光标

强制运行到光标

继续执行,直到到达插入符号的位置。途中的所有断点都将被忽略。

最后修改:2021 年 11 月 19 日