在 VS Code 中尝试

在 VS Code 中管理 Jupyter 内核

Visual Studio Code notebook 的内核选取器可帮助您为 notebook 选择特定的内核。您可以通过单击 notebook 右上角的 Select Kernel 或通过命令面板使用 Notebook: Select Notebook Kernel 命令来打开内核选取器。

打开内核选取器后,VS Code 会显示最近使用的 (MRU) 内核

MRU Kernel

注意:在早期版本的 VS Code(版本 <1.76)中,VS Code 默认会显示所有可用的内核。

要查看其他内核,您可以单击 Select Another Kernel...。所有现有内核都按内核源选项分类,Jupyter 扩展默认支持这些源

Notebook Kernel Picker

默认情况下,VS Code 会推荐您之前用于 notebook 的内核,但您可以选择连接到任何其他 Jupyter 内核,如下所示。VS Code 还会记住您 notebook 上次选择的内核,并在您下次打开 notebook 时自动选择它们。

Jupyter 内核

Jupyter Kernels 类别列出了 VS Code 在其运行的计算系统(您的桌面、GitHub Codespaces、远程服务器等)上下文中检测到的所有 Jupyter 内核。每个 Jupyter 内核都有一个 Jupyter 内核规范,或称 Jupyter kernelspec,其中包含一个 JSON 文件 (kernel.json),该文件提供了有关内核的详细信息,例如名称、描述以及将进程作为内核启动所需的 CLI 信息。

Python 环境

Python Environments 类别列出了 VS Code 在其运行的计算系统(您的桌面、Codespaces、远程服务器等)中检测到的 Python 环境。它按类型(例如 conda、venv)显示所有 Python 环境,无论是否安装了 IPyKernel

注意:您无需jupyter 安装到您想使用的 Python 环境中。只需安装 IPyKernel 包即可将 Python 进程作为内核启动并针对您的 notebook 执行代码 (pip install ipykernel)。请访问 Jupyter 扩展 wiki 了解更多信息。

现有 Jupyter 服务器

Existing Jupyter Server 类别列出了之前连接过的远程 Jupyter 服务器。您还可以使用此选项连接到远程或本地运行的现有 Jupyter 服务器。找到您的 Jupyter 服务器的 URL,例如 http://<ip-address>:<port>/?token=<token>,并将其粘贴到 Enter the URL of the running Jupyter server 选项中,以便连接到该远程服务器并使用该服务器针对您的 notebook 执行代码。

Enter server URL

当您启动远程服务器时,请务必

  1. 允许所有来源(例如 --NotebookApp.allow_origin='*'),以允许从外部访问您的服务器。
  2. 将 notebook 设置为监听所有 IP (--NotebookApp.ip='0.0.0.0')。

连接后,所有活动的 Jupyter 会话将显示在此列表中。

您可以通过以下方式根据服务器的 kernelspec 创建新会话:

  1. 运行 Notebook: Select Notebook Kernel 命令。
  2. 选择 Select Another Kernel
  3. 选择 Existing Jupyter Server
  4. 选择您的服务器。

Codespaces Jupyter 服务器

Connect to Codespace 类别包含一种特殊的 Jupyter 服务器类型,您可以在其中使用由 GitHub Codespaces 提供支持的远程 Jupyter 服务器,GitHub Codespaces 是一种云资源,每月提供最多 60 小时免费使用。要使用 Codespaces Jupyter 服务器

  1. 安装 GitHub Codespaces 扩展

    注意:如果您使用的是 Web 版 VS Code(vscode.devgithub.dev),此扩展已为您安装。另外,请确保 Jupyter 扩展也已安装。

  2. 转到命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)),选择 Codespaces: Sign In 并按照步骤登录 Codespaces。

  3. 单击 notebook 右上角的 Select Kernel 打开内核选取器,选择 Connect to Codespace

    提示:如果您没有看到 Connect to Codespace 选项,请转到命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)),选择 Developer: Reload Window 以重新加载窗口,然后重试。

虽然不是必须的,但您也可以在GitHub Codespaces 页面上管理所有 Codespaces 和 Codespaces Jupyter 服务器。要了解更多信息,您可以阅读GitHub Codespaces 文档

添加内核选项

如果您的机器上没有 Jupyter 内核或 Python 环境,VS Code 可以帮助您设置:转到命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)),选择 Python: Create Environment,并按照提示进行操作。您还可以通过安装 Azure Machine Learning 等附加扩展来添加选择内核的其他方式。

More Kernel Sources

问题或反馈

您可以通过在我们的仓库中创建 issue 来添加功能请求报告问题,我们的工程团队正在积极监控和管理该仓库。