重要
本文档涵盖 IPython 6.0 及更高版本。从 6.0 版本开始,IPython 不再支持与低于 3.3 的 Python 版本(包括所有版本的 Python 2.7)的兼容性。
如果您正在寻找与 Python 2.7 兼容的 IPython 版本,请使用 IPython 5.x LTS 版本并参考其文档(LTS 是长期支持版本)。
安装 IPython¶
IPython 6 需要 Python ≥ 3.3。IPython 5.x 可以安装在 Python 2 上。
快速安装¶
如果已安装 pip
$ pip install ipython
这将安装 IPython 及其依赖项。
如果您想将 IPython 与笔记本或 Qt 控制台一起使用,您还应该安装 Jupyter pip install jupyter
。
概述¶
本文档详细描述了安装 IPython 所需的步骤。有关使用包管理器或完整 Python 发行版快速入门的一些方法,请参阅 IPython 网站的 安装页面。
如果您在安装 IPython 或其任何依赖项时遇到问题,请告诉我们。
IPython 和大多数依赖项应通过 pip 安装。在许多情况下,这是安装 Python 包的最简单方法。可以在 其 PyPI 页面 上找到有关 pip
的更多信息。
可以在 Python 文档 中找到有关安装 Python 包的更一般信息。
依赖项¶
IPython 依赖于许多其他 Python 包。使用 pip 或 conda 等包管理器进行安装将确保安装必要的包。不带依赖项的手动安装是可能的,但并不推荐。可以使用包管理器命令(例如 pip show ipython 或 conda info ipython)查看依赖项。
安装 IPython 本身¶
IPython 需要几个依赖项才能正常工作,不建议手动安装 IPython 及其所有依赖项,因为这可能非常耗时且麻烦。您应该使用 Python 包管理器 pip
。
使用 pip 安装¶
确保已安装最新版本的 pip
(Python 包管理器)。如果没有,请前往 Pip 文档 并首先安装 pip
。
使用 pip 安装 IPython 是启动并运行它的最快方式
$ pip install ipython
就是这样。
从源代码安装¶
要从源代码安装 IPython,请从 PyPI 获取 IPython 的最新稳定 tarball。然后执行以下操作
tar -xzf ipython-5.1.0.tar.gz
cd ipython-5.1.0
# The [test] extra ensures test dependencies are installed too:
pip install '.[test]'
不要直接调用 setup.py
,因为这可能会对进一步升级产生不良后果。我们也不建议使用 easy_install
。
如果你要安装到需要更高权限的位置(如 /usr/local
),则可能需要使用 sudo 运行最后一个命令。你还可以结合使用 pip 中的 --user
标志,在用户特定位置进行安装。
要运行 IPython 的测试套件,请使用 pytest 命令
$ pytest
安装开发版本¶
还可以从我们的 Git 源代码存储库安装 IPython 的开发版本。为此,你需要在系统上安装 Git。
然后执行
$ git clone https://github.com/ipython/ipython.git
$ cd ipython
$ pip install -e '.[test]'
pip install -e . 命令允许用户和开发人员通过在正确的位置创建链接并将命令行脚本安装到适当的位置,来跟踪开发分支的变化。
然后,如果你想随时更新 IPython,请执行
$ git pull
如果依赖项或入口点已更改,你可能需要再次运行
$ pip install -e .
,但这并不常见。