WebC++ — 在浏览器里写、跑、调 C++

不需要后端、不需要装编译器、不需要本机 CLI。 打开一个网页版 VS Code，就能写 C++、在真实终端里交互运行、享受完整补全与诊断，还能下断点单步调试——全部跑在浏览器里（WebAssembly）。

适合：竞赛编程（OI/ACM）练题、教学演示、在线判题前端、临时验证一段 C++。

功能

怎么用（三种方式，别混淆）

注意：VS Code for the Web（vscode.dev）不接受「从 VSIX 安装扩展」。想让用户在网页里用到它， 要么发布到 Marketplace，要么用上面的自托管静态站。

快速开始

1. 安装扩展，打开任意文件夹（或命令面板「WebC++: 打开文件夹」选本地目录）；
2. 新建 main.cpp：

#include <bits/stdc++.h>
int main() {
    int n; scanf("%d", &n);
    printf("%d\n", n * 2);
}

3. Ctrl+Shift+B（或编辑器右上角 ▷）→ 编译并在终端里运行，直接打字输入；
4. 想调试：F5，在行号左边点红点下断点，右侧「运行和调试」面板看变量与调用栈。

页面需要跨源隔离（crossOriginIsolated === true）：clangd 的线程池与终端的交互 stdin 都依赖它。 自托管的配套网页已内置 COOP/COEP 与兜底 Service Worker，Marketplace 版在 vscode.dev 上同样是隔离环境。

操作

首次运行会下载约 28MB 工具链（clang/lld/sysroot），clangd 首次另需约 27MB；之后走浏览器缓存。

设置（oiCpp.*）

已知限制（写前面，省得你踩）

• 单文件模型：一个 .cpp 独立编译运行，不做多文件链接、不做 CMake；每个文件一个终端。
• 调试器不执行代码：std::vector 的 v[i] 能看（按内存布局算），但 v.size()、mp.count(x) 这类需要"真的调用函数"的表达式求不了值——纯 DWARF 引擎做不到。
• 语言子集：无 C++ 异常、无线程、无宿主系统调用（wasi 限制）。
• 优化等级：调试用 -O0；运行默认 -O2，更高级别会让调试信息退化（断点会变少）。
• 浏览器：需要 Chromium 系（Chrome / Edge）。
• Ctrl+Shift+B 会顶掉内置的 "Run Build Task"。

自托管网页（可选）

扩展只是前端；配套的 VS Code Web 静态站也能自己部署：仓库里 npm run pack 生成 dist-cf/， wrangler pages deploy dist-cf 一条命令上线（Cloudflare Pages）。

许可证

• 本扩展：AGPL-3.0-or-later（见 LICENSE）
• 调试器内核 wdb：AGPL-3.0-or-later；其中的 wdb-stub.c 带例外条款， 链接进你的程序不会让你的程序变成 AGPL
• 第三方组件（LLVM / wasi-sdk / 微软 DWARF 引擎等）见 notices/THIRD-PARTY-NOTICES.md

你的代码归你。 本扩展对编译产物不主张任何权利。

反馈

• 扩展问题：https://github.com/hcz1017/oi-web/issues
• 调试器问题（断点 / 单步 / 变量）：https://github.com/hcz1017/wdb/issues