在 VS Code 中试用

网页版 Jupyter Notebook

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

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

Codespaces 上的 Jupyter Notebook

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

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

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

    Use Codespaces Jupyter Notebook Template

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

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

网页版 VS Code 上的 Jupyter Notebook

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

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

使用 VS Code Server 进行远程隧道

您可以在远程机器上安装 VS Code Server,并通过网页版 VS Code 访问它,从而无需 SSH 即可安全地连接到远程机器(您也可以在 VS Code 桌面版上连接到服务器)。为此:

  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 服务器

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

的 URL 来连接到任何远程 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. 将笔记本设置为侦听所有 IP(--NotebookApp.ip='0.0.0.0')。

限制

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

  • 无法访问 VS Code 终端(尽管您可以从笔记本单元格中运行 magic 命令
  • 有限的调试功能
  • 部分 Python 智能感知支持
  • 不支持 isort 扩展

在 Codespaces 上继续工作

与 VS Code 桌面版一样,您可以轻松地从网页版 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 或创建一个新的。这将打开一个新窗口,让您在 Codespaces 上继续处理您的项目。

问题或反馈

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