在 VS Code 中管理 Jupyter 内核
Visual Studio Code 笔记本的内核选择器可帮助您为笔记本选择特定的内核。您可以通过单击笔记本右上角的 **选择内核** 或通过命令面板(使用 **笔记本:选择笔记本内核** 命令)打开内核选择器。
打开内核选择器后,VS Code 会显示最近使用的 (MRU) 内核。
**注意:** 在 VS Code 的早期版本(版本 <1.76)中,VS Code 默认情况下会显示所有可用的内核。
要查看其他内核,您可以单击 **选择其他内核...**。所有现有内核都分类为内核源选项,这些内核源由 Jupyter 扩展默认支持。
默认情况下,VS Code 会推荐您之前与笔记本一起使用的内核,但您可以选择连接到任何其他 Jupyter 内核,如下所示。VS Code 还会记住笔记本上次选择的内核,并在您下次打开笔记本时自动选择它们。
Jupyter 内核
**Jupyter 内核** 类别列出了 VS Code 在其运行的计算系统(您的桌面、GitHub Codespaces、远程服务器等)上下文中检测到的所有 Jupyter 内核。每个 Jupyter 内核都有一个 Jupyter 内核规范 或 Jupyter kernelspec,其中包含一个 JSON 文件 (kernel.json
),其中包含有关内核的详细信息,包括名称、描述以及将进程作为内核启动所需的 CLI 信息。
Python 环境
**Python 环境** 类别列出了 VS Code 在其运行的计算系统(您的桌面、Codespaces、远程服务器等)上下文中检测到的 Python 环境。它显示了按类型分组的所有 Python 环境(例如,conda、venv)——无论是否安装了 IPyKernel。
**注意:** 您**不需要** 将 jupyter 安装到要使用的 Python 环境中。只需要安装 IPyKernel 包才能将 Python 进程作为内核启动,并针对您的笔记本执行代码 (
pip install ipykernel
)。访问 Jupyter 扩展 Wiki 以了解更多信息。
现有 Jupyter 服务器
**现有 Jupyter 服务器** 类别列出了之前连接的远程 Jupyter 服务器。您还可以使用此选项连接到远程或本地运行的现有 Jupyter 服务器。找到 Jupyter 服务器的 URL,例如,http://<ip-address>:<port>/?token=<token>
并将其粘贴到 **输入正在运行的 Jupyter 服务器的 URL** 选项中,以连接到远程服务器并使用该服务器针对您的笔记本执行代码。
启动远程服务器时,请务必
- 允许所有来源(例如
--NotebookApp.allow_origin='*'
),以允许从外部访问服务器。 - 设置笔记本以监听所有 IP(
--NotebookApp.ip='0.0.0.0'
)。
连接后,所有活动的 Jupyter 会话将出现在此列表中。
您可以从服务器的 kernelspec 创建一个新的会话,方法是
- 运行 **笔记本:选择笔记本内核** 命令。
- 选择 **选择其他内核**。
- 选择 **现有 Jupyter 服务器**。
- 选择您的服务器。
Codespaces Jupyter 服务器
**连接到 Codespace** 类别包含一种特殊类型的 Jupyter 服务器,您可以在其中使用由 GitHub Codespaces 提供支持的远程 Jupyter 服务器,GitHub Codespaces 是一种云资源,您每月可以 免费获得高达 60 小时的使用时间。要使用 Codespaces Jupyter 服务器
-
**注意:** 如果您使用的是适用于 Web 的 VS Code (vscode.dev 或 github.dev),则此扩展已为您安装。另外,请确保还安装了 Jupyter 扩展。
-
转到命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)),选择 **Codespaces:登录** 并按照步骤登录 Codespaces。
-
通过单击笔记本右上角的 **选择内核** 打开内核选择器,选择 **连接到 Codespace**。
**提示:** 如果您没有看到 **连接到 Codespace** 选项,请转到命令面板 (⇧⌘P (Windows、Linux Ctrl+Shift+P)),选择 **开发人员:重新加载窗口** 以重新加载窗口并重试。
虽然不是必需的,但您也可以在 GitHub Codespaces 页面 上管理所有 Codespaces 和 Codespaces Jupyter 服务器。要了解更多信息,您可以阅读 GitHub Codespaces 文档。
添加内核选项
如果您机器上没有 Jupyter 内核或 Python 环境,VS Code 可以帮助您设置:转到命令面板 (⇧⌘P (Windows,Linux Ctrl+Shift+P)),选择 **Python:创建环境**,并按照提示操作。您还可以通过安装其他扩展(例如 Azure 机器学习)来添加其他选择内核的方法。