重要

本文档涵盖 IPython 6.0 及更高版本。从版本 6.0 开始，IPython 不再支持与低于 Python 3.3 的 Python 版本兼容，包括所有版本的 Python 2.7。

如果您正在寻找与 Python 2.7 兼容的 IPython 版本，请使用 IPython 5.x LTS 版本并参考其文档（LTS 是长期支持版本）。

安装 IPython 内核

另请参阅

安装 Jupyter

IPython 内核是 Jupyter 的 Python 执行后端。

Jupyter Notebook 和其他前端会自动确保 IPython 内核可用。但是，如果您想在不同版本的 Python 中或在 virtualenv 或 conda 环境中使用内核，则需要手动安装它。

Python 2 和 3 的内核

如果您在 Python 3 上运行 Jupyter，则可以在检查您的 pip 版本是否大于 9.0 后设置一个 Python 2 内核

python2 -m pip --version

然后使用以下命令安装

python2 -m pip install ipykernel
python2 -m ipykernel install --user

或者使用 conda，创建一个 Python 2 环境

conda create -n ipykernel_py2 python=2 ipykernel
source activate ipykernel_py2    # On Windows, remove the word 'source'
python -m ipykernel install --user

注意

IPython 6.0 停止支持 Python 2，因此在 Python 2 上安装 IPython 会为您提供较旧版本（5.x 系列）。

如果您在 Python 2 上运行 Jupyter 并想设置一个 Python 3 内核，请按照相同的步骤操作，将 2 替换为 3。

最后一个命令为当前 python 安装安装一个 kernel spec 文件。内核规范文件是 JSON 文件，可以使用普通文本编辑器查看和更改。

不同环境的内核

如果您想为不同的 virtualenv 或 conda 环境拥有多个 IPython 内核，则需要为内核规范指定唯一名称。

确保在您的环境中安装了 ipykernel。如果您使用 pip 在 conda 环境中安装 ipykernel，请确保安装了 pip

source activate myenv
conda install pip
conda install ipykernel # or pip install ipykernel

例如，使用 conda 环境，在第一个环境中安装一个 Python (myenv) 内核

source activate myenv
python -m ipykernel install --user --name myenv --display-name "Python (myenv)"

在第二个环境中，确保在其中安装了 ipykernel

source activate other-env
python -m ipykernel install --user --name other-env --display-name "Python (other-env)"

Jupyter 在内部使用 --name 值。这些命令将覆盖具有相同名称的任何现有内核。 --display-name 是您在笔记本菜单中看到的内容。

使用 virtualenv 或 conda 环境，您可以将一个环境中的 IPython 内核提供给另一个环境中的 Jupyter。为此，请使用 –prefix 指向 Jupyter 环境，从内核的环境运行 ipykernel install

/path/to/kernel/env/bin/python -m ipykernel install --prefix=/path/to/jupyter/env --name 'python-my-env'

请注意，此命令将在首选位置之一中为内核创建一个新配置（有关更多详细信息，请参见 jupyter --paths 命令）

  • 系统范围（例如 /usr/local/share），

  • 在 Jupyter 的环境中（sys.prefix/share），

  • 按用户（~/.local/share 或 ~/Library/share）

如果您想在安装内核规范之前对其进行编辑，则可以通过两个步骤来完成。首先，要求 IPython 将其规范写入到临时位置

ipython kernel install --prefix /tmp

根据您的喜好编辑 /tmp/share/jupyter/kernels/python3 中的文件，然后当您准备就绪时，告诉 Jupyter 安装它（这会将文件复制到 Jupyter 将查找的位置）

jupyter kernelspec install /tmp/share/jupyter/kernels/python3