安装指南¶

Spyder相对容易安装在Windows、Linux和macOS上。请务必仔细阅读并遵循这些说明。

如果您遇到问题，在发布报告之前， 请 请咨询我们全面的 troubleshooting guide 并搜索 issue tracker 以获取错误消息和问题描述。这些方法通常可以修复或隔离绝大多数与安装相关的困难。谢谢!

重要

Spyder现在提供 standalone installers 对于Windows和MacOS，无需下载 Python 或在现有环境中手动安装，即可更轻松地启动和运行应用程序。虽然我们仍然支持 Python ，但我们建议在这些平台上使用这种安装方法，以避免大多数软件包冲突问题和其他问题。

尝试Spyder online¶

想在不安装Spyder的情况下试用它吗？与 Binder 您可以使用Spyder online的完整功能副本，该副本可在您的web浏览器中运行，无需安装。去参观一下 Spyder page on Binder 现在就开始使用Spyder。

独立安装程序¶

我们针对Windows和MacOS的独立安装程序从Spyder 4.2开始提供。我们建议在这些平台上使用这种安装方法，但我们为Linux、高级用户和特定需求提供了其他几个选项，因此如果您是这样的话，请继续阅读。

下载并安装¶

要下载您的平台支持的Spyder安装程序，只需单击下面的相应链接即可。(对于Linux，请参阅 Python 节)。然后，双击下载的文件以打开安装程序。如果弹出安全警告，您可能需要单击 Yes ， OK ， Open ， Allow 或者类似的。

在Windows上，如果出现SmartScreen对话框，请单击 More info 紧随其后的是 Run anyway ，然后继续执行安装程序中的步骤。

在MacOS上，打开磁盘映像并将Spyder拖到您的 Applications 文件夹。

Windows Installer

macOS Installer

注解

这两个安装程序的“Lite”版本也可以从 releases page ，它比完整的安装程序稍小一些。它们缺少许多可选但推荐的依赖项，如NumPy、SciPy和Pandas，这意味着有几个 变量资源管理器 包括图形数据导入向导在内的功能以及对NumPy数组和Pandas DataFrames的丰富显示和编辑的支持将不可用。鉴于这只节省了少量的空间，而错过了重要的功能，我们建议使用完整的安装程序，除非优先考虑最小化下载/安装大小和内存使用。

从独立安装运行¶

要在独立安装时运行Spyder，只需使用操作系统典型的启动应用程序的方法，比如从Windows上的“开始”菜单(或者任务栏，如果你已经将其固定在那里)，或者从Launchpad、Spotlight或MacOS上的Applications文件夹(或者Dock，如果你已经在那里添加了它)打开它。

在MacOS上，当您第一次打开Spyder时，您可能会看到一条消息，提示您无法打开它，因为无法验证开发人员。如果是，请右键单击该应用程序，选择 Open ，然后单击 Open 在生成的对话框中，将不再显示该警告。您也可以单击 Open Anyway 在……下面 Security & Privacy ‣ General 在系统首选项中。

有关在现有Python环境中安装您自己的软件包和使用独立Spyder的更多信息，请参阅我们的 FAQ 。

Python¶

默认情况下，Spyder包含在 Anaconda Python distribution ，它以一体化软件包的形式提供了入门所需的一切，并且是我们推荐的Linux上的安装方法(在其他平台上也受支持)。

与 Python 一起跑步¶

要在安装了Anaconda之后运行Spyder，在Windows上推荐的方法是通过“开始”菜单快捷方式启动它。在其他平台上，打开Anaconda Navigator，滚动至Spyder Home 然后点击 Launch .

如果Spyder不通过此方法启动，或者您希望使用命令行，请打开Anaconda提示符（Windows）或您的终端（其他平台），请键入 conda activate base 然后 spyder .

新康达环境¶

如果您希望Spyder与其他软件包单独更新，请避免与其他软件包发生冲突。只需在Anaconda提示符（Windows）或终端（其他平台）中运行以下命令，将Spyder最小限度地安装到名为 spyder-env ：

conda create -n spyder-env spyder=4

要安装Spyder的可选依赖项以及完整功能，请改用以下命令：

conda create -n spyder-env spyder=4 numpy scipy pandas matplotlib sympy cython

要从Conda Forge安装Spyder而不是默认的Anaconda频道，请添加 -c conda-forge 在前一个命令的末尾。

然后，您可以使用与上述相同的方法运行Spyder，但请确保使用选择“开始”菜单快捷方式 (spyder-env) 在名称中，选择 spyder-env 在使用Navigator或type启动它之前 conda activate spyder-env 在命令行上启动它之前。

有关此方法以及在现有Python环境和包中使用Spyder的更多信息，请参阅 Guide to working with packages and environments in Spyder .

替代方法¶

警告

虽然我们为需要安装Spyder的用户提供了备选安装选项，但我们目前缺乏资源，无法针对通过这些备选发行版进行安装的特定问题提供个人帮助。因此，我们建议您改用我们的 standalone installers (Windows和MacOS)或 Python 如果您遇到安装问题，您无法自行解决。

Windows¶

Spyder包含在 WinPython 科学的 Python 分布(尽管 Python 的 conda 包和环境管理器不是)。您可以在安装后立即使用Spyder，就像与 Python 一样。

macOS¶

多亏了 MacPorts project ，Spyder可以使用其 port 软件包管理器；但是，随附的Spyder版本可能已过期，或存在Spyder无法控制的MacPorts特定问题。

有 several versions 可供选择。

Linux系统¶

警告

分发包由第三方创建，相对于当前Spyder版本通常已过时，并且可能包含错误并缺少与当前支持的版本相关的功能。因此，鉴于我们无法为他们提供官方支持，我们强烈建议使用 Python 在Linux上，只要可行(或 pip ，适用于高级用户)。

Spyder可以通过第三方发行版软件包安装在大多数常见的Linux发行版上。

以这种方式安装的Spyder运行通常与任何其他安装了发行版的应用程序相同。或者，它也可以通过以下方式从终端启动 spyder (或 spyder3 ，在某些发行版的较旧版本上)。

乌邦图¶

使用包管理器：

sudo apt install spyder

Spyder的Ubuntu软件包可在 Ubuntu package repository 。

Debian¶

使用包管理器：

sudo apt install spyder

Spyder的Debian软件包可在 Debian package repository 。

其他分配¶

Spyder也可以在其他GNU/Linux发行版中使用，比如

Arch Linux

Fedora

Gentoo

openSUSE

有关如何安装Spyder，请参阅发行版的文档。

使用PIP¶

警告

虽然这种安装方法对于有经验的用户来说是一个可行的选择，但是使用安装Spyder(和其他PyData堆栈软件包) pip 可能会导致许多棘手的问题，特别是在Windows和MacOS上。虽然欢迎您自己尝试，但很遗憾，如果您遇到问题，我们没有资源可以帮助您，只能推荐我们的 standalone installers (Windows和MacOS)或 Python 。

您可以使用安装Spyder pip packagemanager，这是大多数Python安装的默认配置。在此方法安装Spyder本身之前，您需要获取 Python 程序设计语言。

注解

由于某些基于DEB的Linux发行版(Debian、Ubuntu、Mint)存在已知问题，您可能还需要安装 pyqt5-dev-tools 先打包，带 sudo apt install pyqt5-dev-tools 。

首先，您需要通过以下方法之一创建并激活安装Spyder的虚拟环境。

用 virtualenvwrapper ：

mkvirtualenv spyder-env

workon spyder-env

否则，在macOS/Linux/Unix上：

python3 -m venv spyder-env

source spyder-env/bin/activate

或在Windows上：

python -m venv spyder-env

spyder-env/Scripts/activate.bat

激活环境后，要安装Spyder及其其他依赖项，请运行 pip install spyder .

您可能需要使用单独安装Qt绑定（PyQt5） pip 如果运行在python2下。

要在安装后启动Spyder，请确保您的环境已激活并运行 spyder3 命令。

更新Spyder¶

要更新通过我们的 standalone packages 在Windows和MacOS上，您当前需要手动下载并安装最新版本(如果在Windows上，请确保首先从控制面板/系统设置中删除旧版本)。

如果您通过Anaconda、WinPython、MacPorts或您的系统包管理器安装了Spyder，请使用相同的方法进行更新。使用Anaconda，只需运行(如果在Windows上，则在Anaconda提示符中，否则在您的系统终端中)：

conda update anaconda

conda update spyder

如果通过高级/跨平台方法安装Spyder， pip 运行 pip install --upgrade spyder . 此命令还将更新所有Spyder依赖项，因此我们建议您使用隔离的虚拟环境，以避免对其他已安装软件包造成任何潜在的意外影响。

开发建设¶

如果您想在下一个Spyder版本发布之前尝试它，您可以！你可能想这样做是为了修复Spyder中的错误，添加新功能，学习Spyder的工作原理，或者只是尝试一下IDE的功能。有关详细信息，请参阅 Contributing Guide 包含在Spyder源代码或Github上，有关详细信息，请参阅 Spyder development wiki .

其他帮助¶

安装或运行Spyder时遇到问题？ 阅读我们的 Troubleshooting Guide and FAQ .

寻找有关Spyder及其生态系统的一般信息？ 看到我们 main website .

需要提交错误报告或功能请求吗？ 看看我们的 Github repository .

Want development-oriented help and information? 咨询我们的 Github wiki .

有帮助请求或讨论主题？ 订阅我们的 Google Group .

问一个快速的问题或者想和开发团队聊天？ 停在我们的 Gitter chatroom .