在 VS Code 中试用

Web 上的 Jupyter Notebook

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

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

Codespaces 上的 Jupyter Notebook

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

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

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

    Use Codespaces Jupyter Notebook Template

  3. 就是这样!将为您创建一个 codespace,以便您入门!

    提示:您可以通过将配置文件提交到您的存储库(通常称为配置即代码 (Configuration-as-Code))来自定义您的项目,这会为项目的所有用户创建可重复的 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 桌面版上连接到服务器)。为此

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

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

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

    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 智能感知支持
  • 不支持 isort 扩展

继续在 Codespaces 上工作

与 VS Code 桌面版一样,您可以轻松地在 Codespaces 上从 Web 版 VS Code(https://vscode.devhttps://github.dev)继续您的工作。当您选择在新的 codespace 中继续在此处工作时,您的未提交更改将随之迁移。为此

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

  2. 选择创建新的 Codespace

    Continue working on

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

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

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

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

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

    Remote explorer tab

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

问题或反馈

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