🚀 在 VS Code 中

Visual Studio Code Web 版

Visual Studio Code Web 版提供免费、零安装的 Microsoft Visual Studio Code 体验,完全在浏览器中运行,使您能够快速安全地浏览源代码仓库并进行轻量级的代码更改。要开始使用,请在浏览器中访问 https://vscode.dev

VS Code Web 版具有您喜爱的 VS Code 桌面版的许多功能,包括浏览和编辑时的搜索和语法高亮显示,以及扩展支持,以便处理您的代码库并进行更简单的编辑。除了从 GitHub 和 Azure Repos 等源代码管理提供程序打开仓库、分支和拉取请求之外,您还可以处理存储在本地计算机上的代码。

VS Code Web 版完全在您的 Web 浏览器中运行,因此与桌面体验相比存在某些限制,您可以在下方阅读更多相关信息。

以下视频快速概述了 Visual Studio Code Web 版。

与 VS Code 桌面版的关系

VS Code Web 版为导航文件和仓库以及提交轻量级代码更改提供了基于浏览器的体验。但是,如果您需要访问运行时来运行、构建或调试代码,您希望使用终端等平台功能,或者您希望运行 Web 中不支持的扩展,我们建议您将工作转移到桌面应用程序、GitHub Codespaces,或者使用 远程 - 隧道 以获得 VS Code 的完整功能。此外,VS Code 桌面版允许您使用不受浏览器限制的完整键盘快捷键集。

当您准备好切换时,您只需点击几下即可“升级”到完整的 VS Code 体验。

您还可以通过选择齿轮图标,然后选择切换到 Insiders 版本...,或直接导航到 https://insiders.vscode.dev,在 VS Code Web 版的稳定版和 Insiders 版本之间切换。

打开项目

通过导航到 https://vscode.dev,您可以创建新的本地文件或项目,处理现有的本地项目,或访问托管在其他位置(例如 GitHub 和 Azure Repos (Azure DevOps 的一部分))的源代码仓库。

您可以像在 VS Code 桌面环境中一样,在 Web 中创建新的本地文件,方法是从命令面板 (F1) 中使用 文件 > 新建文件

GitHub 仓库

您可以按照以下模式直接从 URL 在 VS Code Web 版中打开 GitHub 仓库:https://vscode.dev/github/<组织>/<仓库>。以 VS Code 仓库为例,这看起来像:https://vscode.dev/github/microsoft/vscode

此体验通过自定义的 vscode.dev/github URL 提供,该 URL 由 GitHub 仓库扩展(它是更广泛的 远程仓库扩展的一部分)提供支持。

GitHub 仓库允许您从编辑器中远程浏览和编辑仓库,而无需将代码拉取到本地计算机上。您可以在我们的 GitHub 仓库指南中了解有关该扩展及其工作原理的更多信息。

注意GitHub 仓库扩展也适用于 VS Code 桌面版,以提供快速的仓库浏览和编辑。安装扩展后,您可以使用 GitHub 仓库:打开仓库... 命令打开仓库。

您还可以通过浏览器的搜索栏(又名多功能框)在 vscode.dev 中打开 GitHub 仓库,方法是为 Chrome 和 Edge 安装 vscode.dev 扩展。然后,键入 code 以激活多功能框,后跟您的仓库名称。建议由您的浏览器搜索历史记录填充,因此如果您想要的仓库没有出现,您也可以键入完全限定的 <所有者>/<仓库> 名称来打开它,例如 microsoft/vscode

Type  in your browser and search a GitHub repository to open in vscode.dev

如果您已经在 https://vscode.dev 的 VS Code Web 版中,您还可以通过 远程仓库扩展命令导航到不同的仓库。选择状态栏左下角的远程指示器,您将看到 打开远程仓库... 命令。

GitHub Repositories

Azure Repos

您可以像在 VS Code Web 版中打开 Github 仓库一样打开 Azure Repos。

当您导航到模式为 https://vscode.dev/azurerepos/<组织>/<项目>/<仓库> 的 URL 时,您将能够读取、搜索仓库中的文件并将更改提交到 Azure Repos。您可以获取、拉取和同步更改,以及查看分支。

您可以通过在 Azure Repos URL 前面加上 vscode.dev,在 VS Code Web 版中打开 Azure Repos 中的任何仓库、分支或标记。

或者,当您在 Azure DevOps 仓库或拉取请求中时,您可以按 (.) 在 VS Code Web 版中打开它。

更多自定义 URL

与桌面版一样,您可以通过丰富的扩展生态系统自定义 VS Code Web 版,该生态系统几乎支持每个后端、语言和服务。vscode.dev 包括提供常用体验快捷方式的 URL。

我们已经探索了几个 URL (vscode.dev/githubvscode.dev/azurerepos)。以下是更完整的列表

服务 URL 结构 文档
GitHub /github/<org>/<repo> 更多信息见上文
Azure Repos /azurerepos/<org>/<project>/<repo> 更多信息见上文
Visual Studio Live Share /editor/liveshare/<sessionId> 更多信息见下文
Visual Studio Marketplace /editor/marketplace/<marketplacePublisher>
/<extensionId>/<extensionVersion>
示例路由 编辑 此扩展
Power Pages /power/pages Power Pages 文档
配置文件 /editor/profile/github/<GUID> 配置文件文档
主题 /editor/theme/<extensionId> 更多信息见下文
MakeCode /edu/makecode MakeCode 文档
VS Code for Education /edu VS Code for Education 登陆页
Azure 机器学习 (AML) /+ms-toolsai.vscode-ai-remote-web AML 文档

请注意,某些 URL 必须以特定方式输入(例如,vscode.dev/editor/liveshare 需要活动的 Live Share 会话)。请查看每个服务的文档以获取具体的访问和使用信息。

下面提供了有关其中一些 URL 的更多信息。

主题

您可以通过 VS Code Web 版共享和体验颜色主题,URL 模式为:https://vscode.dev/editor/theme/<extensionId>

例如,您可以访问 https://vscode.dev/editor/theme/sdras.night-owl 以体验 Night Owl 主题,而无需经历下载和安装过程。

注意:颜色主题 URL 模式适用于完全声明式(无代码)的主题。

扩展可以定义多个主题。您可以使用模式 /editor/theme/<extensionId>/<themeName>。如果未指定 themeName,VS Code Web 版将采用第一个主题。

作为主题作者,您可以将以下徽章添加到您的扩展 readme 中,以便用户可以轻松地在 VS Code Web 版中试用您的主题(将 <extensionId> 替换为您的主题扩展的唯一标识符)

[![Preview in vscode.dev](https://img.shields.io/badge/preview%20in-vscode.dev-blue)](https://vscode.dev/editor/theme/<extensionId>)

Visual Studio Live Share

Live Share 访客会话可通过 https://vscode.dev/editor/liveshare URL 在浏览器中使用。sessionId 将传递给扩展,以实现无缝加入体验。

在不同的环境中继续工作

在某些情况下,您可能希望访问能够运行代码的不同环境。您可以切换到在开发环境中处理仓库,该环境支持本地文件系统和完整的语言和开发工具。

GitHub 仓库扩展使您可以轻松地在本地克隆仓库、在桌面上重新打开它,或为当前仓库创建 GitHub 代码空间(如果您安装了 GitHub Codespaces 扩展并有权创建 GitHub 代码空间)。为此,请使用命令面板 (F1) 中提供的 继续在...上工作 命令,或单击状态栏中的远程指示器。

保存和共享工作

在 Web 中处理本地文件时,如果您启用了自动保存,您的工作将自动保存。您也可以像在桌面版 VS Code 中工作时一样手动保存(例如 文件 > 保存)。

处理远程仓库时,您的工作将保存在浏览器的本地存储中,直到您提交它。如果您使用 GitHub 仓库打开仓库或拉取请求,则可以在源代码管理视图中推送更改以持久保存任何新工作。

您还可以通过继续在...上工作在其他环境中继续工作。

首次使用 继续在...上工作 处理未提交的更改时,您可以选择使用 云更改 将您的编辑带到您选择的开发环境,这使用 VS Code 服务来存储您的待处理更改。GitHub 仓库文档中对此进行了进一步描述。

通过远程隧道使用您自己的计算实例

您可以使用 远程 - 隧道扩展在 VS Code Web 版中针对另一台计算机进行开发。

远程 - 隧道扩展允许您通过安全隧道连接到远程计算机,如桌面 PC 或虚拟机 (VM)。然后,您可以从任何地方安全地连接到该计算机,而无需 SSH。这使您可以将“您自己的计算”带到 vscode.dev,从而实现更多场景,例如在浏览器中运行您的代码。

您可以在其文档中了解有关远程 - 隧道的更多信息。

安全探索

VS Code Web 版完全在您的 Web 浏览器的沙盒中运行,并提供非常有限的执行环境。

当从远程仓库访问代码时,Web 编辑器不会“克隆”仓库,而是通过直接从浏览器调用服务的 API 来加载代码;这进一步减少了克隆不受信任的仓库时的攻击面。

当处理本地文件时,VS Code Web 版通过浏览器的文件系统访问 API 加载它们,这限制了浏览器可以访问的范围。

随处运行

GitHub Codespaces 类似,VS Code Web 版可以在平板电脑(如 iPad)上运行。

语言支持

Web 上的语言支持更加细致,包括代码编辑、导航和浏览。桌面体验通常由语言服务和编译器提供支持,这些服务和编译器期望文件系统、运行时和计算环境。在浏览器中,这些体验由在浏览器中运行的语言服务提供支持,这些服务提供源代码标记化和语法着色、补全以及许多单文件操作。

通常,体验分为以下几类

  • 良好: 对于大多数编程语言,VS Code Web 版为您提供代码语法着色、基于文本的补全和括号对颜色化。通过 Tree-sitter 语法树和 anycode 扩展,我们能够为流行的语言(如 C/C++、C#、Java、PHP、Rust 和 Go)提供额外的体验,例如 大纲/转到符号符号搜索
  • 更好: TypeScript、JavaScript 和 Python 体验都由在浏览器中原生运行的语言服务提供支持。使用这些编程语言,您将获得“良好”体验,外加丰富的单文件补全、语义高亮显示、语法错误等。
  • 最佳: 对于许多“Web”语言,例如 JSON、HTML、CSS 和 LESS 等,vscode.dev 中的编码体验几乎与桌面版相同(包括 Markdown 预览!)。

您可以通过状态栏中的语言状态指示器确定当前文件中语言支持的级别

Language status indicator

限制

由于 VS Code Web 版完全在浏览器中运行,因此与桌面应用程序中的功能相比,某些体验自然会受到更多限制。例如,终端和调试器不可用,这很有道理,因为您无法在浏览器沙箱中编译、运行和调试 Rust 或 Go 应用程序。

扩展

只有一部分扩展可以在浏览器中运行。您可以使用扩展视图在 Web 中安装扩展,无法安装的扩展将带有警告图标和 了解原因 链接。我们期望随着时间的推移,会有更多扩展被启用。

Limited extension support

当您安装扩展时,它会保存在浏览器的本地存储中。您可以通过启用设置同步来确保您的扩展在 VS Code 实例(包括不同的浏览器甚至桌面版)之间同步。

当扩展包包含在浏览器沙箱中无法运行的扩展时,您将收到一条信息性消息,其中包含查看包中包含的扩展的选项。

Python extension pack limit

当扩展在浏览器沙箱中执行时,它们会受到更多限制。纯声明式扩展,例如大多数主题、代码片段或语法,可以未经修改地运行,并且在 VS Code Web 版中可用,而无需扩展作者进行任何修改。运行代码的扩展需要更新以支持在浏览器沙箱中运行。您可以在 Web 扩展作者指南中阅读有关支持浏览器中的扩展的更多信息。

还有一些扩展在浏览器中运行时仅提供部分支持。一个很好的例子是语言扩展,它将其支持限制为单个文件或当前打开的文件。

文件系统 API

如今,Edge 和 Chrome 支持 文件系统 API,允许网页访问本地文件系统。如果您的浏览器不支持文件系统 API,您将无法在本地打开文件夹,但可以打开文件。

浏览器支持

您可以在最新版本的 Chrome、Edge、Firefox 和 Safari 中使用 VS Code Web 版。每个浏览器的旧版本可能无法正常工作 - 我们只保证支持最新版本。

提示: 检查兼容浏览器版本的一种方法是查看当前用于测试 VS Code 的 Playwright 版本,并查看其支持的浏览器版本。您可以在 VS Code 仓库的 package.json 文件中找到当前使用的 Playwright 版本,位于 devDependencies/@playwright/test。一旦您知道 Playwright 版本,例如 1.37,您就可以查看其 发行说明中的 浏览器版本 部分。

Webview 在 Firefox 和 Safari 中可能会以不同的方式显示或出现一些意外行为。您可以在 VS Code GitHub 仓库中查看问题查询,以跟踪与特定浏览器相关的问题,例如带有 Safari 标签Firefox 标签的问题。

您可以采取其他步骤来改善您使用 VS Code Web 版的浏览器体验。查看其他浏览器设置部分以获取更多信息。

移动设备支持

您可以在移动设备上使用 VS Code Web 版,但较小的屏幕可能会有一些限制。

键盘快捷键

某些键盘快捷键在 Web 中也可能以不同的方式工作。

问题 原因
⇧⌘P (Windows, Linux Ctrl+Shift+P) 在 Firefox 中无法启动命令面板。 ⇧⌘P (Windows, Linux Ctrl+Shift+P) 在 Firefox 中被保留。
作为一种解决方法,请使用 F1 启动命令面板。
⌘N (Windows, Linux Ctrl+N) 用于新建文件的快捷键在 Web 中不起作用。 ⌘N (Windows, Linux Ctrl+N) 会打开一个新窗口。
作为一种解决方法,您可以使用 Ctrl+Alt+N(macOS 上为 Cmd+Alt+N)。
⌘W (Windows Ctrl+F4, Linux Ctrl+W) 用于关闭编辑器的快捷键在 Web 中不起作用。 ⌘W (Windows Ctrl+F4, Linux Ctrl+W) 会关闭浏览器中的当前标签页。
作为一种解决方法,您可以使用 Ctrl+Shift+Alt+N(macOS 上为 Cmd+Shift+Alt+N)。
⇧⌘B (Windows, Linux Ctrl+Shift+B) 不会切换浏览器中的收藏夹栏。 VS Code Web 版会覆盖此快捷键并重定向到命令面板中的“构建”菜单。
Alt+左Alt+右 应该在编辑器内导航,但可能会错误地触发标签页历史记录导航。 如果焦点在编辑器外部,这些快捷键会改为触发标签页历史记录导航。

其他浏览器设置

当在浏览器中使用 VS Code 时,您可以采取其他浏览器配置步骤。

打开新标签页和窗口

在某些情况下,您可能需要在 VS Code Web 版中工作时打开新的标签页或窗口。VS Code 在从剪贴板读取内容时可能会要求您授予访问剪贴板的权限。根据您的浏览器,您可以通过不同的方式授予对剪贴板的访问权限或允许弹出窗口

  • Chrome、Edge、Firefox:在浏览器的设置中搜索“站点权限”,或在地址栏右侧查找以下选项

Allow clipboard access in the browser

  • Safari:在 Safari 浏览器中,转到 偏好设置... > 网站 > 弹出窗口 > 您正在访问的域(例如,vscode.dev),然后从下拉列表中选择 允许