报告问题

感谢您提供有关 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 帮助菜单启动经典笔记本，以确保您获得与 JupyterLab 使用的完全相同的笔记本服务器。

   • 我可以在经典 Jupyter Notebook 中重现问题：问题可能不在 JupyterLab 中。 它可能在 Jupyter Notebook 服务器、您的内核等中。 请根据您的判断向相关项目提交问题。

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

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

   • 我无法在私密浏览模式下重现问题：重置您的 cookie 或其他浏览器状态可能会有所帮助。

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

您还可以检查您的系统，看看是否有

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

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

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

创建问题

在创建问题之前，请在错误跟踪器中搜索相关问题。 如果您找到描述您问题的错误，请在其中添加以下信息，而不是创建新的错误。 如果您找到相关的已解决问题（已关闭并锁定讨论），请创建一个新问题并引用已解决的问题。

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

• 相关软件包版本，包括

  • jupyterlab 和 notebook 版本

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

  • 操作系统和版本

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

• 展示问题的截图或简短的屏幕录像

创建一个新的问题。包含上述上下文信息。描述您如何按照上述诊断步骤得出结论，这是一个 JupyterLab 问题。

JupyterLab 中的交流遵循 Jupyter 社区指南。