常见问题解答#
安装与更新#
Q: How do I install Spyder?
Q: How do I install Spyder on Windows Subsystem for Linux 2 (WSL2)?
如果您已经在Windows机器上安装了Spyder，那么如果您的代码必须在基于WSL2的Linux环境中运行，您不需要在那里重新安装它。
相反，只需在WSL2中安装Miniconda并创建一个新的conda环境（或使用现有的conda或virtualenv），然后在该环境中安装Spyder-Kernels，例如使用conda install spyder-kernels。
您必须手动安装ipython_genutils，例如使用conda install ipython_genutils。
注意
Windows会创建一个位于\\wsl$的网络路径，该路径指向您的WSL2机器分区，例如\\wsl$\Ubuntu-20.04。
您必须为机器路径映射一个网络驱动器号，例如W:，以便Spyder能正确识别其文件和文件夹。
要启动Spyder内核，请从Linux终端运行
python -m spyder_kernels.console --matplotlib="inline" --ip=127.0.0.1 -f=~/remotemachine.json &
它将以子进程方式运行内核，并在您的WSL主目录中创建一个名为remotemachine.json的文件。
最后，在Spyder的IPython控制台选项菜单中，按照使用外部内核中的描述选择连接到现有内核。
将remotemachine.json的绝对路径填入连接文件字段。
如果您按照上述说明映射了W:驱动器，路径应为W:/home/username/remotemachine.json。
Spyder中将打开一个新的控制台，运行在Linux环境下。
尝试运行os.system('ls -la')，查看是否列出您的WSL主文件夹。
如果您从Spyder运行exit()，运行在Linux上的内核将被停止。
Q: How do I update Spyder using conda?
从命令行（或在Windows上是Anaconda提示符）运行：
conda update anaconda
conda update spyder
如果这导致错误或未能将Spyder更新至最新版本，请尝试：
conda install spyder=5
Q: How do update I Spyder using Anaconda Navigator?
在Navigator的Home下打开Spyder部分的"齿轮"菜单。 转到Install specific version并选择您想要使用的Spyder版本。 我们强烈推荐使用最新的可用版本，以获得新功能、错误修复、性能改进和可用性增强的好处。
运行Spyder#
Q: How do I run Spyder?
您可以通过以下任意方式启动它：
从命令行: 在终端中(Windows上是Anaconda提示符)输入
spyder。从Anaconda Navigator启动: 在Home下滚动到Spyder，然后点击Launch。
*仅限Windows*: 通过开始菜单快捷方式启动它。
Q: What are the system requirements for Spyder? How resource-intensive is it?
Spyder可在Windows、macOS和Linux的现代版本上运行（推荐版本见下表），支持通过Anaconda及其他方式安装。 空闲时通常CPU占用较低，内存消耗约为0.5GB至1GB，具体取决于使用时长以及打开的文件、项目、面板和控制台数量。 建议采用双核及以上x64处理器和至少4GB内存的系统运行，但若要同时运行其他应用程序，强烈推荐8GB内存以获得最佳性能。 请注意，用户运行的代码（如科学计算和深度学习模型）可能需要超出Spyder本身基础配置的额外资源。
操作系统 |
版本 |
|---|---|
Windows |
Windows 8.1 |
macOS |
High Sierra (10.13) |
Linux |
Ubuntu 16.04 |
Q: How do I run Spyder installed in a conda environment using Anaconda Navigator?
在Applications on下选择您想要启动Spyder的环境。 如果Spyder已安装在此环境中，您将在Navigator的Home窗口中看到它。 点击Launch在您选择的环境中启动Spyder。
Q: How do I run Spyder installed in a conda environment using the command line?
通过在终端（或在Windows上的Anaconda提示符）中输入以下命令来激活您的conda环境：
conda activate <ENVIRONMENT-NAME>
然后，输入 spyder 以启动在该环境中安装的版本。
使用Spyder#
Q: How do I install Python packages to use within Spyder if I installed Spyder with conda?
安装软件包的首选方法应该是使用conda。 在您的系统终端（或Windows上的Anaconda Prompt）中，输入：
conda install <PACKAGE-NAME>
如果您的安装未成功，请按照我们视频中第2部分第3至5步操作，该视频讲解了如何解决和避免pip、Conda及Conda-Forge相关的问题。
Q: How do I get Spyder to work with my existing Python packages/environment?
要在Spyder中使用现有环境，请将新IPython控制台的默认Python解释器指向该环境。
为此，请打开Spyder首选项中的Python解释器部分（在Windows/Linux上是工具 ‣ 首选项，在macOS上是Spyder ‣ 首选项）。 在这里，选择使用以下Python解释器选项，并通过下方的下拉菜单选择您偏好的环境。 如果未列出您需要的环境，请参阅下方说明。
注意
如果您将Miniconda（或其他基于Conda的发行版）安装到了非默认路径，或者正在使用由pyenv以外的工具管理的虚拟环境，那么您的环境可能不会被列出。
相反，请使用文本框或选择文件按钮输入您想要使用的Python解释器路径。 您可以通过在终端中激活要使用的venv或Conda环境（Windows上是Anaconda Prompt），然后运行以下命令来找到此路径：
python -c "import sys; print(sys.executable)"
最后，在Consoles菜单中点击Restart kernel以使更改生效。
如果spyder-kernels尚未安装，IPython Console将显示如何安装正确版本的说明。
在终端（Windows上是Anaconda Prompt）中激活环境后执行给定的命令，最后再次重启内核。
Q: How do I install Python packages to use within Spyder if I downloaded Spyder from the standalone installers?
观看我们关于使用附加软件包的视频或按照以下说明操作。
如果您想在Spyder中使用我们安装程序未包含的其他软件包，您需要自行安装Python发行版；我们推荐Miniconda或其他基于Conda的选项。 为了让Spyder能自动识别，您应该使用默认安装路径的基于Conda的发行版。
创建一个包含spyder-kernels和您想使用的包的新conda环境。
例如，如果您想使用scikit-learn，请打开终端（或在Windows上打开Anaconda提示符）并运行以下命令：
conda create -n my-env -c conda-forge spyder-kernels scikit-learn
最后，按照上述回答中的说明，通过更改Spyder的默认Python解释器，将Spyder连接到这个my-env环境。
Q: How do I reset Spyder’s preferences to the defaults?
可以通过Spyder菜单栏中工具下的将Spyder重置为出厂默认设置，或使用Windows开始菜单中的重置Spyder设置快捷方式，亦或在系统终端（Windows上是Anaconda提示符）中运行spyder --reset命令。
Q: How do I change Spyder’s language?
在Spyder的首选项中的常规下，转到高级设置选项卡，并从语言下显示的选项中选择您的语言。
Q: How do I use code cells in Spyder?
要在Spyder的编辑器中创建单元格，请在脚本中输入#%%。
每个#%%都会生成一个新单元格。
要运行单元格，请按Shift-Enter（当光标聚焦在该单元格时）或使用Spyder工具栏中的运行当前单元格按钮。
Q: How do I use plugins with Spyder (e.g. Spyder-Notebook, Spyder-Terminal, Spyder-Unittest)?
Spyder插件可在conda-forge conda渠道获取。
要安装一个插件，请在命令行（或在Windows上的Anaconda Prompt）中输入：
conda install -c conda-forge <PLUGIN>
将
Q: How do I clear all variables before executing my code?
在运行菜单下的每个文件的配置...对话框中勾选执行前移除所有变量选项。
Q: How do I run my code in a dedicated console or an external system terminal?
在Run菜单下的Configuration per file…对话框中选择适当的选项。
Q: How do I change the syntax highlighting theme in the Editor?
前往首选项，在外观部分的语法高亮主题下选择您想要的主题。
故障排除#
Q: I’ve found a bug or issue with Spyder. What do I do?
Q: I get an error in the IPython console running my code! Help!
首先，请确保您看到的错误不是代码中的bug。 为了确认这一点，可以尝试在任何标准Python解释器中运行它。 如果错误仍然出现，问题可能出在您的代码上，像Stack Overflow这样的网站可能是最好的起点。 否则，请从我们故障排除指南中的基本急救部分开始。
Q: Code completion/help doesn’t work; what can I do?
如果在调用提示、悬停提示或帮助面板中没有显示任何内容，请确保您正在检查的对象具有文档字符串，并尝试在IPython控制台中执行您的代码以获取帮助和自动补全。 如果这不起作用，请尝试通过右键单击Spyder主窗口底部状态栏中的LSP Python标签项，并选择重启Python语言服务器选项来重启PyLS。
如需了解更多信息，请前往故障排除指南中常见问题页面的代码补全/帮助功能失效章节。
Q: I get the message “An error occurred while starting the kernel”. How do I fix this?
首先，请确保您安装的Spyder-Kernels版本与Spyder兼容。 请查阅故障排除指南中Spyder-Kernels未安装/不兼容部分的表格进行验证。
要安装正确的版本，请在命令行（或Windows上的Anaconda Prompt）中输入以下内容
conda install spyder-kernels=<VERSION>
Q: Spyder doesn’t launch or is slow on macOS Big Sur. How can I get it working?
Spyder正处于更新最后阶段，以实现与macOS 11 Big Sur的完全兼容，该版本将作为4.2.1版本的一部分在2020年底发布。 不过，您可以通过下面的临时解决方案立即使用它。 请确保已安装Anaconda或Miniconda发行版，并在终端中运行以下命令，在干净的环境中通过Conda-Forge安装Spyder：
conda create -n spyder-dev python=3 conda activate spyder-dev conda install -c conda-forge spyder
然后，每当您想启动Spyder时，在终端中运行以下命令：
conda activate spyder-dev
export QT_MAC_WANTS_LAYER=1
spyder
关于Spyder#
Q: What’s Spyder’s licensing situation? Is commercial use allowed?
Spyder是100%免费且开源的；没有付费版本或禁止商业使用的限制。 它由国际用户社区开发，并通过OpenCollective获得用户支持，以及包括Quansight和NumFOCUS在内的慷慨赞助组织支持。 我们的源代码、独立安装程序以及大多数分发方式（Pip/PyPI、Linux发行版、MacPorts、WinPython等）都可以被任何人自由地重新分发、使用和修改，用于任何目的，包括商业用途。 有关Anaconda情况的更多详情，请参阅该问题。
Q: What do the Anaconda licensing changes mean for Spyder?
如果您使用Anaconda发行版中的Spyder，他们最近更改了其服务条款，对大规模使用Anaconda的大型（员工超过200人）营利性公司增加了限制。
不过，这些条款仅适用于软件包基础设施（完整的Anaconda发行版和defaults conda频道）。
作为替代方案，您可以简单地下载类似的Miniforge发行版，它是100%开源的，与完整版Anaconda完全相同（除了不包含Anaconda base环境中默认安装的Python包，我们建议您无论如何都避免使用这些包，因为这里出现的任何问题都可能破坏您的整个安装）。
然后，像往常一样使用conda安装您需要的软件包（包括Spyder，如果您没有使用我们推荐的独立安装程序）。
Miniforge将自动使用社区维护的Conda-Forge存储库，该存储库拥有更多样化的软件包，通常比Anaconda的等效存储库更及时更新，而且没有任何商业限制。
更多信息，请参阅我们的安装指南。