安装指南

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。

Spyder running on Binder

独立安装程序

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

下载并安装

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

在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 .

Anaconda Navigator showing Spyder

如果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 在命令行上启动它之前。

Running Spyder installation with conda

有关此方法以及在现有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发行版中使用,比如

有关如何安装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 .

Running Spyder installation with pip

您可能需要使用单独安装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 .