提交报告#

如果排查步骤未能解决您的问题,您可以将其提交到我们的问题追踪器,以便我们的团队为您检查。您需要一个Github 账户才能执行此操作,因此在开始之前请确保您已拥有一个(这始终是个好主意)。

Github page on Spyder's issue tracker

重要

在提交问题之前,请确保您已经在 Google 和 Spyder 的问题追踪器上搜索过问题的描述和相关的错误回溯信息,以确保此问题之前未被提交过。如果是重复问题,您的提交将被关闭。

提交问题的方式#

有几种提交问题的方式,可以直接从 Spyder 或 GitHub 提交。以下按优先级和难易程度排序:

  1. 如果 Spyder 出现错误对话框,您可以直接从对话框中提交问题。您需要填写问题的标题,说明导致此问题的步骤,然后点击提交至 Github。这将预先填写一份错误报告,其中包含您的环境详细信息、关键版本和依赖项,并自动为您插入错误/回溯信息。

    Github page on Spyder's issue tracker
  2. 如果 Spyder 能够打开,且您的问题不涉及错误对话框,最好的方法是直接从帮助菜单中选择报告问题,这将手动调出问题报告表单,并填写有关您的 Spyder 安装的关键信息。描述您遇到的问题(包括任何错误/回溯信息),并提供一个描述性的标题,然后点击提交至 Github

    Github page on Spyder's issue tracker
  3. 如果 Spyder 无法启动,您可以在 Github 上的问题页面手动提交报告。与上述情况不同,您需要手动提供所有项目的版本(Spyder、Python、操作系统、Qt/PyQt、Anaconda 和 Spyder 的依赖项),如错误报告模板中所列;有关详细信息,请参见下文。

    Github page on Spyder's issue template

提交报告后,我们的团队将尽快回复您,通常在 24 小时内或更短时间,尽力帮助您解决问题。

报告中应包含的内容#

请在您的报告中尽可能多地包含以下内容,以最大程度地增加获得相关帮助的机会,并帮助我们诊断、重现和解决您的问题。

主要项目,按优先级排序:

  • 完整、完整的错误消息或回溯信息,按 Spyder 显示的精确内容复制/粘贴或自动输入

    • 直接从错误对话框自动生成的报告应自动包含此信息,但请再次检查以确保。

    • 您可以从错误对话框的显示详细信息部分复制并粘贴此内容。

    • 如果不存在,或者未显示对话框,您也可以在 Spyder 的内部控制台中找到它,该控制台位于视图菜单下的窗格 ‣ 内部控制台

    • 如果您愿意,或者 Spyder 无法启动,您可以从命令行(或 Windows 上的 Anaconda 提示符)使用 spyder 启动 Spyder,并复制在那里打印的输出。

    注意

    如果您报告的是特定行为而非错误,或者消息未能完全解释发生的情况,请详细描述实际发生的情况以及您期望 Spyder 执行的操作。

  • 详细、分步说明您在错误发生之前所做的确切操作,如果适用,请附上触发错误的示例代码。

  • 有关 Spyder 及其环境的信息,如错误报告模板中所列,您可以在帮助菜单下的关于 Spyder 中找到;以及其主要依赖项,显示在帮助 ‣ 依赖项对话框中(有一个按钮可以复制粘贴它们)。

    Spyder showing Spyder's info and dependencies

    如果 Spyder 无法启动,请将命令行(或 Windows 上的 Anaconda 提示符)中 conda list 的输出粘贴到问题模板的依赖项部分。

    Command line showing output of conda list
  • 您如何安装 Spyder 以及任何其他相关软件包,例如 Anaconda、MacPorts 或 pip,以及自安装以来 Spyder 是否正常工作过

  • 您还尝试了哪些方法来解决问题例如本指南或其他网站上的方法,以及您是否尝试在独立的 QtConsole、IPython 和/或纯 Python 解释器中重现问题。

  • 问题之前是否在类似情况下持续发生,或者这是您第一次观察到它。

  • 关于您的系统、环境、软件包或特定用法中任何其他特殊或不寻常的情况,可能与问题有关。

提示

如果在报告中包含代码块,请务必在其前后加上一行三个反引号 ```,以获得像这样的代码块

print("Your Code Here!")

否则,您的代码可能包含随机格式或缺少缩进,这会使检查和运行代码以重现和修复您的问题变得困难。