基本急救¶

这些建议虽然更像是一种散弹枪式的方法，但往往只靠它们自己就能解决大多数报告的问题。

建议的故障排除步骤¶

重新启动Spyder ，然后再试一次。
升级Spyder 到最新版本，您可能会发现您的问题已得到解决（以及新功能、增强和其他错误修复）。小版本每两个月发布一次，所以除非你最近更新过，否则你的版本很可能不是最新的。你可以通过 Check for updates 命令 Help 菜单。

要使用Conda执行更新（强烈建议），请从您的终端（或Windows上的Anaconda提示符）运行：
```
conda update anaconda
conda update spyder
```
更新Spyder的依赖项和环境 ，或者安装最新版本的发行版（例如推荐的Anaconda），或者在终端中使用相关的“update all”命令（或Windows上的Anaconda提示符）。要使用Conda获取所有内容的最新稳定版本，可以运行：
```
conda update qt pyqt spyder-kernels ipython ipykernel jupyter_client jupyter_core pyzmq
```
重新启动机器 ，以防问题出在延迟过程或其他类似问题上。
还原Spyder的配置文件 这就解决了Spyder的各种问题。从终端（或Windows上的Anaconda提示符）运行：
```
spyder --reset
```
注解

这将重置您的首选项，以及任何自定义键盘快捷键或语法高亮显示方案。如果你特别关心这些，你应该复制一份 .spyder-py3 用户主目录中的文件夹 (C:/Users/YOUR_USERNAME 在Windows上， /Users/YOUR_USERNAME 在macOS上，或 /home/YOUR_USERNAME 如果这不能解决问题，请稍后恢复。
尝试将Spyder安装到新的Conda环境中 （推荐）或 virtualenv/venv ，并查看问题是否再次出现。

在您的系统终端（或Windows上的Anaconda提示符）中，运行以下命令以创建一个全新、干净的环境，并在其中启动Spyder：

conda create -n spyder-env spyder -y
conda activate spyder-env
spyder

如果这样可以解决问题，则问题很可能是由于系统上安装了另一个包，尤其是使用pip时，这可能会导致许多问题，应尽可能避免。

看我们的视频 解决和避免问题与pip，康达和康达锻造，并遵循其指示。

重新安装Spyder¶

如果前面的步骤都不能解决您的问题，您应该通过最初安装Spyder的任何方式对其进行完全卸载。

对于 Python ，请按照 Anaconda uninstall guide ，删除Anaconda目录的原始安装位置，并（在Windows上）删除 %appdata%/python 目录（如果存在）。

然后，对最新版本的 Anaconda distribution 我们建议您安装Spyder并保持更新。

重要

我们只为您个人安装Spyder的其他问题提供支持。特别是，pip安装虽然可行，但实际上只有专家才可以安装，因为有许多陷阱和特定于您的设置的不同问题，这就是为什么我们建议尽可能使用Conda。欲了解更多信息，请访问我们的安装指南 .

隔离问题¶

如果在运行特定的行、块或脚本/程序时出现错误，则这可能不是Spyder的问题，而是它所依赖的包中较低级别的问题。尝试按以下顺序运行它，直到它开始如您所期望的那样工作。如果你成功地隔离了这个bug，就把它报告给最后一个不工作。

斯派德 当然，它本身！如果可能，请确保在关闭和重新打开后可以重现错误。
一个空的QtConsole实例 ，例如，从Anaconda navigator或从Anaconda提示符/终端/命令行（Windows/Mac/Linux）启动 jupyter qtconsole .

QtConsole是Spyder运行代码所依赖的GUI控制台，因此涉及到Spyder的大多数问题实际上是QtConsole的问题，可以报告给他们 issue tracker .
IPython命令行shell ，与例如。 ipython 从Anaconda提示符/Terminal/command line（Windows/Mac/Linux）启动。可复制的错误可以报告给他们 Github page ，不过一定要先阅读他们的指导方针和文档。
标准的Python解释器 ，或者作为脚本文件运行 python path/to/your/file.py 或以交互方式启动 python 从Anaconda提示符/Terminal/command line（Windows/Mac/Linux）启动。虽然发现Python bug并非不可能，但它更可能是代码本身或您所使用的包的问题，因此最好的源代码是 Python docs 以及上面列出的其他资源。

小技巧

如果问题以类似或相同的方式再次出现在这些方法中（除了Spyder本身），那么几乎可以肯定，Spyder不存在问题，最好在其他地方处理。因为我们通常无法处理与Spyder无关的问题，比如 Stack Overflow 或者相关软件包的文档是获得帮助或报告问题的更好的地方。

见呼救为其他地方寻找信息和帮助。

调试和修补¶

即使你知道Spyder是用同样的语言编写的，你也可以用它来诊断问题。您可以使用 Internal Console ，在菜单项下可用 View ‣ Panes ‣ Internal Console .

要获得更详细的调试输出，请从命令行启动Spyder（在Windows上为Anaconda提示符），方法是 spyder --debug-info verbose .

即使您自己无法解决问题，此输出也可以非常有助于我们快速缩小范围并为您解决问题。