报告问题#

感谢您提供有关 JupyterLab 的反馈。

诊断问题#

如果您在 JupyterLab 中发现问题，请按照以下步骤诊断并报告问题。遵循这些步骤有助于您诊断问题是否可能来自 JupyterLab 或来自其他项目。

  1. 尝试在安装了最新官方 JupyterLab 且没有额外包的新环境中重现该问题。

    如果您正在使用 conda

    1. 创建一个新环境

      conda create -n jlab-test --override-channels --strict-channel-priority -c conda-forge -c nodefaults jupyterlab

    2. 激活环境

      conda activate jlab-test

    3. 启动 JupyterLab

      jupyter lab

    • 我无法在干净的环境中重现此问题：问题可能不在 JupyterLab 本身。转到步骤 2。

    • 我可以在干净的环境中重现此问题：转到步骤 3。

  2. 也许问题出在您安装的某个 JupyterLab 扩展中。一次安装一个您曾安装的 JupyterLab 扩展，并在安装每个扩展后检查问题。

    • 我安装特定扩展后可以重现该问题：该扩展可能导致了问题。向该扩展的问题跟踪器提交问题。请务必提及您在此处为缩小问题范围所做的工作。

    • 我安装所有扩展后无法重现该问题：好消息！您可能只需要更新 JupyterLab 和扩展。如果这解决了问题，太好了！如果它没有解决问题，您可能遇到了更复杂的问题。直接转到创建问题。

  3. 尝试在经典的 Jupyter Notebook 中重现该问题。从 JupyterLab 帮助菜单启动经典的 notebook，以确保您获得的是 JupyterLab 正在使用的完全相同的 notebook 服务器。

    • 我可以使用经典的 Jupyter Notebook 重现该问题：问题可能不来自 JupyterLab。它可能在 Jupyter Notebook 服务器、您的内核等中。请您自行判断向相应的项目提交问题。

    • 我无法在经典的 Jupyter Notebook 中重现该问题：转到步骤 4。

  4. 尝试在浏览器的隐身或私人浏览模式下重现该问题。在私人浏览模式下运行可确保您的浏览器状态干净。

    • 我无法在私人浏览模式下重现该问题：也许重置您的 cookie 或其他浏览器状态会有帮助。

    • 我可以在私人浏览模式下重现该问题：转到创建问题。

您可能还会检查您的系统是否存在

  • 可能阻止访问文件或网络接口的安全软件

  • 可能阻止浏览器和服务器之间通信的网络设备、路由器或代理

  • 可能更改 JupyterLab 代码或应用程序页面的浏览器扩展

创建问题#

在创建问题之前，请在问题跟踪器中搜索相关问题。如果您发现描述您问题的问题，请在那里评论以下信息，而不是创建新问题。如果您发现已解决的相关问题（已关闭并锁定讨论），请创建新问题并引用已解决的问题。

要创建问题，请收集以下上下文信息

  • 相关包版本，包括

    • jupyterlab 和 notebook 版本

    • 受影响的浏览器版本（请至少尝试在 Chrome 和 Firefox 中重现）

    • 操作系统和版本

  • 相关的服务器和 JavaScript 错误消息

  • 说明问题的截图或短视频

创建新问题。包括上述上下文信息。描述您如何遵循上述诊断步骤得出这是 JupyterLab 问题的结论。

JupyterLab 中的沟通遵循 Jupyter 社区指南。