现已推出!阅读 10 月份的新功能和修复。

网络上的 Jupyter 笔记本

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

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

Codespaces 上的 Jupyter 笔记本

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

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

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

    Use Codespaces Jupyter Notebook Template

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

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

适用于 Web 的 VS Code 上的 Jupyter 笔记本

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

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

使用 VS Code Server 在 Web 版 VS Code 上进行远程隧道连接

您可以通过在远程计算机上安装 VS Code Server 并通过 Web 版 VS Code 访问它(您也可以连接到桌面版 VS Code 上的服务器),安全地连接到远程计算机,而无需 SSH。要做到这一点

  1. 在远程计算机上安装 code CLI

    注意:如果桌面版 VS Code 已经安装在远程计算机上,则可以跳过此步骤,因为 code CLI 已内置到桌面版 VS Code 中。

  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. 打开笔记本文件,并选择任何 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 服务器:

    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 终端(但您可以从笔记本单元格运行 魔术命令
  • 调试功能有限
  • Python IntelliSense 支持不完整
  • 没有 isort 扩展支持

继续在 Codespaces 上工作

与桌面版 VS Code 一样,您可以轻松地从 Web 版 VS Code (https://vscode.devhttps://github.dev) 继续在 Codespaces 上工作。当您选择 继续在 中工作时,未提交的更改将与您一起迁移。要做到这一点

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

  2. 选择 创建新的 Codespace

    Continue working on

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

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

您也可以手动提交更改并通过**远程资源管理器**创建代码空间。

  1. 通过打开命令面板(⇧⌘P(Windows,Linux Ctrl+Shift+P))并选择**代码空间:登录**来登录代码空间。

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

    Remote explorer tab

从**远程资源管理器**视图中,您可以连接到现有代码空间或创建一个新代码空间。这将打开一个新窗口,让您继续在代码空间上处理项目。

问题或反馈

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