现已推出!了解 11 月的新功能和修复。

Web 上的 Jupyter Notebook

Visual Studio Code 支持在桌面端使用 Jupyter Notebook,并扩展到各种基于浏览器的平台,如 GitHub Codespaces适用于 Web 的 VS Code

使用这些基于浏览器的平台,您可以处理您的笔记本(以及更多!),而无需在您的机器上安装任何东西。您可以在下面阅读有关每个选项以及如何开始的更多信息

Codespaces 上的 Jupyter Notebook

在 VS Code 中开发 Jupyter Notebook 可以完全通过基于 Web 的界面使用 GitHub Codespaces 来完成,这是一个云托管的开发环境,安全且可配置,具有免费的计算资源(关于 Codespaces 的更多信息,请参阅 每月使用配额)。这意味着您可以利用 VS Code 的所有功能,包括 Jupyter Notebook 支持,而无需在您的机器上安装任何东西。要快速开始

  1. 导航到 https://github.com/codespaces

  2. 浏览快速入门模板 下,为 Jupyter Notebook 选择 使用此模板。如果您没有看到 Jupyter Notebook 模板,请选择 查看全部 并搜索该模板。

    Use Codespaces Jupyter Notebook Template

  3. 就这样!将为您创建一个 Codespace 以开始使用!

    提示:您可以通过将 配置文件 提交到您的存储库(通常称为配置即代码)来自定义您的项目,这会为您的项目的所有用户创建可重复的 Codespace 配置。您还可以在 devcontainers/images 存储库中查看预定义配置的示例,以根据需要使用和/或修改您的项目。

适用于 Web 的 VS Code 上的 Jupyter Notebook

您还可以通过访问 https://vscode.devhttps://github.dev(在 GitHub 上查看存储库时键入“.”即可访问)来使用 适用于 Web 的 VS Code。使用适用于 Web 的 VS Code,您有两种选项可以连接到以下类型的内核以用于您的笔记本

  1. 使用 VS Code Server 进行远程隧道连接
  2. 连接到远程 Jupyter 服务器

使用 VS Code Server 进行远程隧道连接

您可以通过在远程机器上安装 VS Code Server 并通过适用于 Web 的 VS Code 访问它来安全地连接到远程机器,而无需 SSH(您还可以连接到 VS Code Desktop 上的服务器)。为此

  1. 在您的远程机器上安装 code CLI

    注意:如果远程机器上已经安装了 VS Code Desktop,则可以跳过此步骤,因为 code CLI 已内置于 VS Code Desktop 中。

  2. 使用 tunnel 命令创建 安全隧道code tunnel(如果您希望使用 VS Code 的 每日发布版本,也可以运行 code-insiders tunnel),然后按照提示授予对服务器的访问权限。这将下载并在您的远程机器上启动 VS Code Server,然后为其创建一个隧道。

  3. 使用与此远程机器关联的 CLI 输出 vscode.dev URL,例如
    https://vscode.dev/tunnel/<machine_name>/<folder_name>
    以便在任何客户端上访问此远程机器。

  4. 打开一个笔记本文件,然后选择任何 Jupyter 内核或 Python 环境来运行您的代码。

连接到远程 Jupyter 服务器

您还可以通过粘贴格式为的 URL 来连接到任何远程 Jupyter 服务器
http://<ip-address>:<port>/?token=<token>.

为此,选择 Jupyter:指定用于连接的 Jupyter 服务器 命令,然后粘贴您的远程 Jupyter 服务器的 URL。

Enter Jupyter server

要使用旧版本的 VS Code 和 Jupyter 扩展输入您的远程 Jupyter 服务器 URL

  1. 单击状态栏上的 Jupyter Server:

    Jupyter Server Status bar item

  2. 选择 现有

    Select Existing option from the Jupyter Server drop down

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

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

限制

由于适用于 Web 的 VS Code 完全在您的 Web 浏览器中运行,因此与桌面和 Codespaces 体验相比,存在一些限制。

  • 无法访问 VS Code 终端(尽管您可以从笔记本单元运行 magic 命令
  • 调试受限
  • 部分 Python IntelliSense 支持
  • 不支持 isort 扩展

继续在 Codespaces 上工作

与 VS Code Desktop 一样,您可以轻松地从适用于 Web 的 VS Code (https://vscode.devhttps://github.dev) 继续在 Codespaces 上工作。当您选择在新 Codespace 中 继续工作 时,您未提交的更改将随您一起转移。为此

  1. 打开命令面板(⇧⌘P (Windows、Linux Ctrl+Shift+P),然后选择 继续工作...

  2. 选择 创建新 Codespace

    Continue working on

  3. 按照提示将您的工作更改存储在云中并登录到 Codespaces。

  4. 选择您的 Codespace 的实例类型(内核数、RAM 和存储)。

您还可以手动提交您的更改并通过 远程资源管理器 创建一个 Codespace

  1. 通过打开命令面板(⇧⌘P (Windows、Linux Ctrl+Shift+P)并选择 Codespaces:登录 来登录到 Codespaces。

  2. 从活动栏导航到 远程资源管理器 视图。

    Remote explorer tab

远程资源管理器 视图中,您可以连接到现有的 Codespace 或创建一个新的 Codespace。这将打开一个新窗口,以便您继续在 Codespaces 上处理您的项目。

问题或反馈

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