报告问题

感谢您提供关于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. 尝试在浏览器的隐身或隐私浏览模式下重现问题。在隐私浏览模式下运行可以确保您的浏览器状态是干净的。

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

   • 我可以在隐私浏览模式下重现问题：前往创建问题。

您可能还需要检查您的系统是否有以下内容：

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

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

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

创建一个问题

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

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

• 相关的包版本，包括：

  • jupyterlab 和 notebook 版本

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

  • 操作系统及版本

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

• 截图或简短的屏幕录像说明问题

Create a new issue. 包括上述的上下文信息。描述你是如何按照上述诊断步骤得出结论这是JupyterLab的问题。

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