WebC++ — 在浏览器里写、跑、调 C++不需要后端、不需要装编译器、不需要本机 CLI。 打开一个网页版 VS Code,就能写 C++、在真实终端里交互运行、享受完整补全与诊断,还能下断点单步调试——全部跑在浏览器里(WebAssembly)。 适合:竞赛编程(OI/ACM)练题、教学演示、在线判题前端、临时验证一段 C++。 功能
怎么用(三种方式,别混淆)
快速开始
操作
首次运行会下载约 28MB 工具链(clang/lld/sysroot),clangd 首次另需约 27MB;之后走浏览器缓存。 测试用例(对拍)—— 仿 CPH 的最小版命令行
判定口径(OI 实用默认):每行忽略行尾空白、忽略末尾空行;非零退出但输出对得上仍算 AC。 不做 OJ 自动抓题——题目站点各异、抓取规则易碎,手动粘贴更稳。 设置(
|
| 键 | 默认 | 说明 |
|---|---|---|
flags |
-std=c++14 -DLOCAL |
传给编译器的参数(clangd 也用同一份)。默认对齐多数 OI 判题机;要用 C++17/20 自己改 |
opt |
2 |
优化级别 0–3 |
debugInfo |
true |
生成 DWARF(调试与外部工具需要) |
verbose |
false |
终端里显示工具链加载日志 |
lsp |
true |
是否启用 clangd |
preload |
true |
启动时后台预加载编译/调试资产(约 41MB,不含 clangd) |
testTimeout |
2000 |
对拍单个用例的超时(毫秒,200–60000;面板里也能直接改) |
anycodePrompt |
true |
首次打开 C/C++ 时询问是否关闭网页版 anycode 的补全 |
桌面版:零配置写 C++
宗旨:不需要装 clang、gcc、CMake、任何语言服务器,装完扩展就能写 C++。 编译器(Clang 22 编成 WASM)、标准库、clangd 全部随扩展内置,跑在扩展自己的 Worker 里, 对本机环境零依赖、零污染——不想为了跑一道题去配环境时,它就是平替。
同一个 VSIX 同时支持网页版和桌面版:
| 能力 | 网页版 | 桌面版 |
|---|---|---|
| 编译 / 运行 / 交互输入 | ✅ | ✅ |
| 补全 / 悬浮 / 跳转 / 诊断 / inlay hints | ✅ 内置 clangd(WASM) | ✅ 同样内置 clangd(WASM),不需要装 clangd |
| 断点 / 单步 / 变量 / watch | ✅ | ✅ |
点进 #include <vector> 看头文件 |
✅ | ✅ |
桌面版说明:
- 不读写你的系统编译器,也不需要
PATH里有任何 C++ 工具;卸载扩展即"清理干净" - 首次加载要解压/编译内置工具链(几秒),之后走缓存
- 首次启动会在后台预加载编译/调试资产(约 41MB,不含 clangd),之后编译/调试秒开;
流量敏感可把
oiCpp.preload设为false - 「打开本地文件夹」是网页版专属(File System Access API);桌面版用 VS Code 自带的打开文件夹
- 排障:命令面板
WebC++: 显示日志,第一行是环境自述(uiKind / 跨源隔离 / SAB), 以及[stage]阶段日志(解压 → glue 加载 → callMain → 已连接)
关于补全:网页版内置的 anycode 会问你一次
网页版(vscode.dev / 自托管)内置了一个叫 anycode 的扩展。它不是真语言服务,而是用
tree-sitter 语法树猜的「近似模式」,官方说明写着:"Any identifier of the current document
and the names of all known declarations are always suggested as completions"。
于是敲个 int 就会冒出满屏别的文件里出现过的语句,还和本扩展的 clangd 重复。
所以第一次打开 C/C++ 文件时,WebC++ 会用 VS Code 官方弹窗问你一次:
要关闭 anycode 的 C/C++ 代码补全吗? [关闭 anycode 补全(推荐)] [保持原样]
- 只问一次,选了什么就记住什么,之后不再打扰;不会擅自改你的设置。
- 只关补全(
completions一个键):跳转 / 引用 / 大纲 / 面包屑 / 常量高亮全部保留 —— clangd 首次预热约 5 秒,这期间它们还能顶着用;也没有禁用 anycode 扩展本身。 - 代码高亮不受影响:高亮来自内置 cpp 语言基础(TextMate
source.cpp), anycode 的 package.json 连languages/grammars都没贡献,结构上无关。 - 想改主意:命令面板
WebC++: 处理 anycode 补全(网页版),或手动在 settings.json 里 增删"[cpp]": { "anycode.language.features": { "completions": false } }。 - 完全不想看到这个弹窗:把
oiCpp.anycodePrompt设为false(默认true)。 - 没打开工作区也能生效:写的是用户(Global)设置,不是工作区设置;万一被宿主拒绝, 会在输出面板给出手工写法提示。
⚠️ 重要提示:clangd ≠ gcc,请只在日常练习时使用
本插件内置的是 clangd / Clang 22,而你比赛或 OJ 上用的多半是 gcc/libstdc++。 两者在下面这些地方行为不同,交卷前务必留个心眼:
- clangd 可能"自动补"上没写的头文件(include 建议 / 修复建议),编辑器里看着能编译,
实际提交到 gcc 就 CE。千万别靠提示补头文件,该
#include的自己要写全。 - 标准库实现不同:
bits/stdc++.h、__int128、pbds(ext/pb_ds)在 gcc 上有、在 libc++ 上未必有 (我们提供了兼容的bits/stdc++.h,但 pdbs 之类不保证)。 - 一些 GCC 扩展(
__attribute__细节、-fgnu89-inline、变长数组的边界行为)与 Clang 不完全一致。 - 未定义行为(越界、溢出、求值顺序)在两边可能给出不同结果——本地过了不等于 OJ 过。
结论:本插件定位是「随手练习 / 验证思路」,不作为比赛提交前的唯一验证环境。 真正上场前,用你 OJ 对应的编译器(g++ / C++17 或 C++14)再过一遍。
已知限制(写前面,省得你踩)
- 单文件模型:一个
.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