VSCode不直接运行WebAssembly，需依赖wasmtime、Chrome或HTTP服务；构建前提是在终端中emcc、cargo、clang等编译器可用，且Rust需添加wasm目标，C/C++需用WASI SDK或Emscripten编译器。
VSCode 本身不运行 WebAssembly，它只调用 wasmtime、chrome 或本地 HTTP 服务来加载和执行 .wasm 文件；配置失败的主因不是插件没装全，而是终端里 emcc、cargo 或 clang 根本不可用。
终端能跑通编译命令，才是 VSCode 构建成功的硬前提
VSCode 的 tasks.json 只是把你在终端里敲的命令再执行一遍。如果终端输入 cargo --version 报错，那 Ctrl+Shift+B 必然失败。
- Rust 用户：确认
rustc --version和cargo --version可用，并已执行rustup target add wasm32-unknown-unknown（浏览器）或wasm32-wasi（本地运行时） - C/C++ 用户：别信系统自带的
clang——它不支持--target=wasm32-wasi。必须用 WASI SDK 或 Emscripten 提供的编译器，验证方式是终端运行emcc --version或${env:WASI_SDK_PATH}/bin/clang --version - macOS 用户特别注意：从 Dock 启动 VSCode 时，
PATH常被重置。改用已source过环境变量的终端执行code .启动
tasks.json 中的 command 必须指向真实可执行文件，且参数完整
写死路径（如 /opt/wasi-sdk/bin/clang）在不同机器上极易失效；用环境变量更可靠，且必须显式指定目标平台与调试信息。
- Rust 推荐用
wasm-pack build --target web --debug，它自动加-g和生成.wasm.map，比裸cargo build更适合前端集成 - C/C++ 若用 WASI SDK，
command应为"${env:WASI_SDK_PATH}/bin/clang"，args至少含：--target=wasm32-wasi、--sysroot=${env:WASI_SDK_PATH}/share/wasi-sysroot、-g、-O0（-O0关闭优化，否则变量名和行号丢失） - 务必设
"isBackground": true并配问题匹配器（如"$gcc"），否则错误只闪现在终端，不会出现在 Problems 面板
launch.json 调试断点不命中？先查浏览器是否加载了源码
VSCode 断点灰色、点击无效，90% 是因为 Chrome DevTools 的 Sources 面板里根本找不到 src/lib.rs 或 src/add.c——说明 .wasm.map 没生效，而非 VSCode 配置错了。
- 确保 HTTP 服务返回
.wasm.map且响应头为Content-Type: application/json（用python3 -m http.server 8000或 Live Server 扩展均可） - JS 加载逻辑不能用
WebAssembly.instantiateStreaming()——它不支持 source map；改用fetch().then(r => r.arrayBuffer()).then(bytes => WebAssembly.instantiate(bytes, imports)) -
launch.json中的sourceMapPathOverrides要对齐实际路径，Rust 项目常见写法是"*": "${webRoot}/*"，而不是默认的 webpack 模板
调试本质是“宿主进程 + 源映射”，不是直接单步 wasm 字节码
VSCode 不解析 .wasm 二进制，它靠浏览器或 wasmtime 提供运行时上下文，再通过 DWARF 信息和 .wasm.map 回溯到原始源码。一旦 -g 缺失、.wasm.map 路径错位、或服务器 MIME 类型不对，整个链路就断了。
- 用
wabt/bin/wasm-decompile --debug-names xxx.wasm | head -20可快速验证.wasm是否真含调试段 - Chrome DevTools → Settings → Preferences → Sources → 必须勾选 “Enable JavaScript source maps” 和 “Enable WebAssembly source maps”
- 若用
wasmtime调试，launch.json的program必须指向wasmtime可执行文件，args才传.wasm文件路径
最常被忽略的其实是 HTTP 服务对 .wasm.map 的响应头和 JS 加载方式——这两处一错，前面所有配置都白搭。
