常见问题解答 (FAQ)#

以下是一些常见问题。点击问题以查看我们文档或GitHub仓库中的相关信息。

通用#

用法#

笔记本#

我的笔记本正在iframe中显示单元格输出。当来回滚动时，它们会被重置。

自 JupyterLab v4 起，笔记本渲染已优化为仅显示所需的单元格。 这对 iframes 有副作用。

当前的解决方法是设置Notebook => Windowing mode为defer或none。 这将在打开长笔记本和/或大量文件时对JupyterLab的性能产生负面影响。

我的笔记本注入了自定义的CSS，导致出现意外的滚动问题（例如，无法滚动到活动单元格）。

自 JupyterLab v4 起，笔记本渲染已优化为仅显示所需的单元格。 它不支持更改元素的 CSS margin （特别是对于单元格）。

解决方法是优先注入自定义的padding而不是margin。 如果无法避免更改边距，可以将设置Notebook => Windowing mode设置为defer或none。 这将在打开长笔记本和/或大量文件时对JupyterLab的性能产生负面影响。

提示与技巧#

  • 如何每次启动JupyterLab时都使用一个干净的工作区？

将 c.ServerApp.default_url = '/lab?reset' 添加到您的 jupyter_server_config.py 中。 有关更多信息，请参阅 如何创建 jupyter_server_config.py。

开发#

  • 如何贡献？

  • 如何扩展或自定义JupyterLab？

  • 在经典的Notebook中，我可以使用单元格输出的自定义Javascript来编程控制Notebook。我可以在JupyterLab中做同样的事情吗？

    JupyterLab被构建为支持广泛的扩展性，包括基于notebook输出的动态行为。要访问这种扩展性，你应该编写一个自定义的JupyterLab扩展。如果你想在用户执行notebook中的某些代码时触发一些行为，你可以输出一个自定义的mimetype（MIME渲染器插件）。我们目前不允许从Javascript渲染器访问JupyterLab API，因为这会将内核和notebook输出与JupyterLab绑定，并使其他前端难以支持它。 有关更多讨论和潜在的替代解决方案，请参见问题 #4623 和 #5789。