🚀 在 VS Code 中获取

Web 上的 Jupyter Notebook

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

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

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,您可以通过以下两种方式连接到 Notebook 的以下类型的内核

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

  3. 使用 CLI 的输出 vscode.dev URL 绑定到此远程计算机,例如
    https://vscode.dev/tunnel/<machine_name>/<folder_name>
    用于在任何客户端上访问此远程计算机。

  4. 打开 Notebook 文件并选择任何 Jupyter Kernel 或 Python 环境以运行您的代码。

连接到远程 Jupyter 服务器

您还可以通过粘贴 URL(格式为
http://<ip-address>:<port>/?token=<token>.

)来连接到任何远程 Jupyter 服务器。为此,请选择Jupyter:指定 Jupyter 服务器以进行连接命令,然后粘贴您的远程 Jupyter 服务器的 URL。

Enter Jupyter server

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

  1. 单击状态栏上的 Jupyter 服务器:

    Jupyter Server Status bar item

  2. 选择现有

    Select Existing option from the Jupyter Server drop down

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

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

限制

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

  • 无法访问 VS Code 终端(但您可以从 Notebook 单元格运行 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 上处理您的项目。

问题或反馈

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