VSCode本身不编译也不执行WebAssembly，仅调度外部工具并连接浏览器或wasmtime调试；能否调通取决于三处：编译命令是否带-g、.wasm.map是否正确加载、launch.json源码路径是否对齐。
VSCode 本身不编译也不执行 WebAssembly，它只是调度 clang、rustc、wasm-pack 或 emcc 这些外部工具，并把浏览器或 wasmtime 当作“运行时调试器”。能不能调通，关键在三处：编译命令是否带 -g（或等效配置）、.wasm.map 文件是否被正确加载、VSCode 的 launch.json 是否能对齐源码路径。
clang 编译 C/C++ 到 wasm 时必须加 -g 和 --target=wasm32-wasi
用系统默认的 clang 直接编译会失败——它不认 wasm 目标。你得用 WASI SDK 或 Emscripten 提供的 clang：
- WASI SDK 方式：
/opt/wasi-sdk/bin/clang --target=wasm32-wasi -g -O0 -o add.wasm add.c，-g生成调试信息，-O0关闭优化（否则变量名和行号全丢） - Emscripten 方式：
emcc -g -O0 --source-map-base http://localhost:8080/ add.c -o add.wasm，--source-map-base告诉浏览器从哪找.wasm.map - 别用
WebAssembly.instantiateStreaming()加载——它不支持 source map；改用fetch().then(r => r.arrayBuffer()).then(bytes => WebAssembly.instantiate(bytes, imports))
Rust 项目用 wasm-pack build --debug 而不是 cargo build
cargo build --target wasm32-unknown-unknown 生成的 .wasm 没有 JS 绑定胶水代码，也没自动配好 .wasm.map 路径。真正可调试的流程是：
- 确保
Cargo.toml中有[lib]+crate-type = ["cdylib"] - 运行
wasm-pack build --target web --debug，它会输出pkg/xxx_bg.wasm和同名.wasm.map - 检查
pkg/xxx.js里是否包含import.meta.url或显式map加载逻辑；若没有，手动在 JS 中加WebAssembly.compileStreaming(fetch('xxx_bg.wasm')).then(...)并确保服务器返回application/wasmMIME 类型
Chrome DevTools 里断点不命中？先查 Sources 面板有没有 .rs 或 .cpp 文件
VSCode 断点灰色、点击无效，90% 是因为浏览器根本没加载到源码。打开 Chrome DevTools → Sources → 左侧文件树，展开你的本地域名，看是否有 src/lib.rs 或 src/add.cpp ——没有就说明 source map 没生效：
立即学习“C++免费学习笔记（深入）”；
- 确认 HTTP 服务返回了
.wasm.map，且响应头是Content-Type: application/json - 检查
launch.json中的sourceMapPathOverrides：比如 Rust 项目常用"webpack:///./src/*": "${webRoot}/src/*"，但若你没用 webpack，就得改成"*": "${webRoot}/*" - Chrome 设置里必须勾选
Enable JavaScript source maps和Enable WebAssembly source maps（Settings → Preferences → Sources）
CodeLLDB 调试本地 wasmtime 时，launch.json 必须指定 --debug 参数
浏览器调试只适用于 JS 调用 Wasm 的场景；想单步进 add() 函数内部（比如看寄存器或内存变化），得切到命令行运行时。这时 VSCode 不通过浏览器，而是靠 CodeLLDB 附加到 wasmtime 进程：
-
wasmtime启动命令必须含--debug，例如：wasmtime --debug --invoke add add.wasm 1 2 -
launch.json的args字段要完整复制该命令，不能漏掉--debug；否则 LLDB 收不到 DWARF 信息，直接报 “no debug info” - 确保
add.wasm是用-g编译的，且wasmtime版本 ≥ 14.0（旧版不支持调试符号解析）
最易忽略的一点：所有调试路径都依赖源码路径与 source map 中记录的路径严格一致。Rust 项目中 pkg/xxx_bg.wasm.map 里写的 "sources": ["../src/lib.rs"]，而你的 webRoot 指向的是项目根目录，那 ../src/lib.rs 就会解析失败——这时候不是改代码，是得在 sourceMapPathOverrides 里硬映射过去。
