vscode.dev 完全指南:在浏览器中运行 Visual Studio Code for the Web
vscode.dev 完全指南:在浏览器中运行 Visual Studio Code for the Web
2021 年 10 月 20 日,微软正式将 vscode.dev 域名指向一个"轻量级"的 VS Code 浏览器版本,宣告 VS Code 十余年前"完全运行在浏览器、无需安装"的愿景迈出关键一步。本文以官方博客 blogs/2021/10/20/vscode.dev 为骨架,结合本仓库中的 VS Code for the Web 用户指南、Web 扩展作者指南 与 Remote Tunnels 文档,系统讲解 vscode.dev 的本地开发能力、语言支持分级、扩展生态、GitHub/Azure Repos 集成以及定制 URL 机制,让你既能快速上手,也能理解其背后的架构设计。
从闲置域名到浏览器 IDE:vscode.dev 的由来
2019 年 .dev 顶级域名开放时,微软注册了 vscode.dev 并将其临时指向官方网站。两年后,这个域名被赋予真正的使命:当你访问 https://vscode.dev 时,看到的是一个完全运行在浏览器中的 VS Code 轻量版本——无需任何安装,即可打开本地文件夹开始编码。
这一产品形态是 VS Code 原始愿景(构建一个可完全无服务器运行在浏览器中的开发工具)的实现。从架构上看,VS Code for the Web 与桌面版共享同一套编辑器内核,但运行环境从 Node.js 运行时切换到了浏览器沙箱,因此其能力边界、扩展模型与语言服务的工作方式都发生了深刻变化,具体细节将在下文展开。
本地开发 + 云工具:零安装的本地编码方案
vscode.dev 最重要的能力之一,是配合现代浏览器的 File System Access API(当前 Edge 和 Chrome 支持)在获得你授权后直接访问本地文件系统,从而把"零安装"的本地开发变成现实。官方博客列出的典型场景包括:
- 本地文件查看与编辑:即使你所在的机器受限、无法安装完整版 VS Code,依然可以通过 vscode.dev 查看和编辑本地文件,例如快速记录 Markdown 笔记并实时预览。
- 构建纯客户端应用:结合浏览器自身的调试工具,编写 HTML、JavaScript、CSS 应用。
- 低性能设备:在 Chromebook 这类不易安装 VS Code 的设备上编辑代码。
- iPad 开发:通过"文件"App 上传/下载文件(甚至可以存放到云端),并借助内置的 GitHub Repositories 扩展远程打开仓库。
如果你的浏览器不支持本地文件系统 API,也不必担心:vscode.dev 仍允许你通过浏览器上传和下载单个文件来打开它们,系统会给出明确的"Local File System Access is Unsupported"提示对话框,此时你会退回到单文件编辑模式。
更轻量的体验:能力边界在哪?
由于 VS Code for the Web 完全运行在浏览器内,相比桌面版,部分体验天然受限:
- 终端与调试器不可用:你无法在浏览器沙箱内编译、运行和调试 Rust 或 Go 应用(虽然 Pyodide、web containers 等新技术未来可能改变这一点)。
- 语言服务运行方式不同:桌面版的语言体验通常由语言服务和编译器驱动,它们期望完整的文件系统、运行时与计算环境;而在浏览器中,这些体验由完全运行在浏览器内的语言服务提供(无文件系统、无运行时),负责源码分词、语法着色、补全以及大量单文件操作。
语言支持分级:Good / Better / Best
浏览器环境下,不同语言获得的编辑体验大致分为三个层级,这也是理解 vscode.dev 能力上限的关键框架:
Good(基础级):对大多数编程语言,vscode.dev 提供语法着色、基于文本的补全和括号对着色。更进一步的体验(如大纲/跳转符号、符号搜索)则通过 Tree-sitter 的实现思路),覆盖 C/C++、C#、Java、PHP、Rust、Go 等流行语言。其原理可从 api/extension-guides/web-extensions.md 中印证:vscode-anycode 使用以 C/C++ 编写、编译为 WebAssembly 的 tree-sitter,因为浏览器运行时只支持 JavaScript 与 WebAssembly 两种执行环境。
Better(增强级):TypeScript、JavaScript 和 Python 由原生运行在浏览器中的语言服务驱动,在 Good 基础上额外获得丰富的单文件补全、语义高亮、语法错误提示等能力。
Best(完整级):对 JSON、HTML、CSS、LESS 这类"web 化"语言,vscode.dev 的编码体验与桌面几乎一致——包括 Markdown 预览在内。这一点在 docs/remote/vscode-web.md 中同样得到确认,其背后的实现细节(内置 JSON、CSS、HTML 语言服务器已被改造成可在浏览器运行的 Web 扩展,语言服务器运行在 Web Worker 中、通过 postMessage 协议通信)可进一步参考 Web 扩展中的语言服务器协议。
你可以在状态栏的 Language Status Indicator(语言状态指示器)中查看当前文件所处的语言支持级别。
扩展生态:浏览器中的扩展能做什么?
vscode.dev 支持绝大多数 UI 定制类扩展——主题、键映射(keymaps)、代码片段(snippets)开箱即用,并且可以通过 Settings Sync 在浏览器、桌面与 GitHub Codespaces 之间漫游你的设置与扩展。
对于运行 Node.js 代码、使用操作系统特定模块或调用本地可执行文件的扩展,它们仍会出现在搜索结果中,但会被明确标记为"不可用"(浏览器会弹出扩展不可用的通知提示)。与此同时,越来越多扩展已更新为支持浏览器运行,且数量与日俱增。
如果你是扩展作者,想让自己的扩展在浏览器中可用,官方推荐的做法在 Web Extensions 作者指南 中有完整阐述,其核心机制可概括为:
- 入口点切换:Web 扩展的清单(
package.json)用browser属性(而非桌面版的main属性)声明入口文件;只声明main而无browser的扩展会被 Web 扩展宿主忽略,无法在浏览器中安装。 - 运行时受限:Web 扩展运行在 Web Worker 环境中,无法动态 import 模块(代码必须打包为单文件)、无法创建子进程或执行外部程序、无法使用
process/os/path等 Node.js 全局与库,工作区文件需通过vscode.workspace.fs访问。 - 自动启用规则:VS Code 会自动把一个扩展视为 Web 扩展,只要它声明了
browser入口点;或者它没有main入口点,且不包含localizations、debuggers、terminal、typescriptServerPlugins等贡献点。 - 打包工具:webpack(
target: 'webworker')或 esbuild 将源码与依赖打包成单文件;语言服务器等重量级功能可通过 Web Worker + LSP 的浏览器实现(自vscode-languageserver-node3.16.0 起)在浏览器中运行。
两个典型的浏览器可用扩展示例:
- Luna Paint - Image Editor:直接在 VS Code 中编辑位图图像,提供图层、混合等丰富设计工具,并可保存图像到本地磁盘。
- GitHub Issue Notebooks:将 Notebook 体验带入 GitHub Issues,可在单个编辑器中交错排列查询、结果与描述查询目的的 Markdown。
GitHub 集成:远程仓库、PR 与 Continue On
许多 VS Code 扩展都围绕 GitHub 上存储的源码工作,例如 CodeTour(创建代码库引导式导览)和 WikiLens(将仓库变成支持双向链接的笔记工具)。为了让访问 GitHub 代码更简单,vscode.dev 内置了 GitHub Repositories、Codespaces 与 Pull Request 扩展,你可以:
- 快速编辑仓库文件;
- 审查 Pull Request;
- 通过 Continue Working On("Continue on")把工作流无缝衔接到本地克隆,或更进一步创建 GitHub Codespace,从而获得更强的语言体验,或在合并提交前完成构建、运行与测试。
根据 docs/sourcecontrol/github.md 的说明,GitHub Repositories 扩展基于 Remote Repositories 架构,允许你在不把代码拉到本地的情况下远程浏览和编辑仓库;而在浏览器场景下,它也正是 vscode.dev/github 这条定制 URL 的驱动引擎。带未提交更改时使用 Continue Working On,你还可以通过 Cloud Changes 服务把这些待提交更改带入目标开发环境。
vscode.dev 与 github.dev 有何不同?
github.dev 是 VS Code for the Web 的定制实例,与 GitHub 深度集成:登录自动完成、URL 沿用 github.com 的 /organization/repo 模型(把 .com 改为 .dev 即可编辑仓库),并使用 GitHub 的浅色/深色主题。而 vscode.dev 是一个更通用的浏览器版 VS Code 入口,支持 GitHub 之外更多的托管服务。
两条路由:vscode.dev/github 与 vscode.dev/azurerepos
除了 GitHub,VS Code for the Web 还支持 Azure Repos(Azure DevOps 的一部分)。你无需记忆路由规则——只需在任意 URL 前加上 vscode.dev 前缀即可:
- 将
https://github.com/microsoft/vscode改为https://vscode.dev/github.com/Microsoft/vscode; - 将
https://dev.azure.com/...改为https://vscode.dev/dev.azure.com/...。
当前 Azure Repos 支持处于预览模式,仅支持读取仓库,官方正在推进完整的读写能力。对于 GitHub 与 Azure DevOps 之外的仓库托管服务,可以通过扩展提供支持(前提是该扩展支持完全在浏览器中运行)。
定制 URL:vscode.dev 的轻量分发机制
与桌面版一样,你可以通过丰富的扩展生态定制 VS Code for the Web;与桌面版不同,vscode.dev 可以借助预装扩展,通过独特的 vscode.dev URL 交付定制体验。例如访问 https://vscode.dev/theme/sdras.night-owl,即可"现场"体验流行的 Night Owl 主题——无需经历下载安装流程。
主题作者还可以在自己的 README.md 中放置一个徽章(badge),让用户直接从 Marketplace 试驾主题。注意:theme URL 只适用于完全声明式(无代码)的主题。仓库中的 VS Code for the Web 用户指南 进一步补充了主题 URL 的完整 schema:/editor/theme/<extensionId>/<themeName>,未指定 themeName 时使用扩展的第一个主题;同时给出了可粘贴进 README 的徽章 Markdown 写法。
另一个例子是 Live Share:访客会话可通过 https://vscode.dev/liveshare URL 在浏览器中加入,sessionId 会被传给扩展以实现无缝加入。
文档 中给出了更完整的定制 URL 一览,除 GitHub / Azure Repos / Live Share / Themes 外,还包括 Visual Studio Marketplace(/editor/marketplace/<publisher>/<extensionId>/<version>)、Profiles(/editor/profile/github/<GUID>)、MakeCode(/edu/makecode)、VS Code for Education(/edu)、Azure Machine Learning 等。需要注意,部分 URL 必须以特定方式使用(例如 vscode.dev/editor/liveshare 需要一个活动中的 Live Share 会话),请查阅各服务的文档。
进阶:把"自带计算"带进浏览器
当本地文件、远程仓库都无法满足运行需求时,vscode.dev 还支持通过 Remote - Tunnels 扩展接入你自己的计算实例。根据 docs/remote/tunnels.md:
- 在远程机器上运行
code tunnel(codeCLI 内置在 VS Code Desktop 中,也可独立下载),即可下载并启动 VS Code Server 并建立安全隧道; - 命令会输出形如
https://vscode.dev/tunnel/<machine_name>/<folder_name>的 URL,在任何客户端打开它即可连接; - 首次连接需通过 GitHub 账号登录授权;
- 该模式消除了源码必须存在于客户端机器的限制——扩展与命令直接在远程机器上执行,从而在浏览器中获得接近本地的开发体验(完整 IntelliSense、代码导航与调试)。
安全与局限:值得了解的边界
安全模型:VS Code for the Web 完全运行在浏览器沙箱中,提供受限的执行环境。访问远程仓库时,Web 编辑器并不会"克隆"仓库,而是直接从浏览器调用托管服务的 API 加载代码,从而进一步降低克隆不可信仓库的攻击面;处理本地文件时则通过浏览器文件系统访问 API 加载,浏览器会限制可访问的范围。
浏览器支持:最新版 Chrome、Edge、Firefox 和 Safari 均可使用(官方仅保证最新版本的支持);Webview 在 Firefox 和 Safari 中可能表现不同或出现意外行为。
移动端与快捷键:vscode.dev 可在移动设备(如 iPad)上运行,但小屏幕存在一定局限;部分键盘快捷键在浏览器中行为不同——例如 Firefox 中 F1 保留给了 Command Palette 的打开动作,新建文件/关闭编辑器的快捷键在浏览器中可能被浏览器自身占用。
结语
把 VS Code 带到浏览器,既是产品原始愿景的实现,也是全新旅程的开始。一个"随时可得的临时编辑器"——任何拥有浏览器和网络连接的人都能使用——正为"随时随地编辑任何东西"的未来打下基础。本文所依托的仓库文档(用户指南、Web 扩展指南、Remote Tunnels)会随产品演进持续更新,是深入研究 vscode.dev 架构细节与最新能力的第一手资料。






