VSCode不直接运行WebAssembly，而是通过浏览器（wasm32-unknown-unknown）或本地运行时（如wasmtime/wasmer）执行；调试需匹配目标平台、生成debug信息、配置正确launch.json与tasks.json，并启用source map。
VSCode 本身不运行 WebAssembly，它只负责编辑、编译调度和调试集成；真正运行 .wasm 模块的是浏览器（通过 WebAssembly.instantiateStreaming）或本地运行时（如 wasmtime）。你卡住的地方，大概率是工具链没对齐、路径没导对，或者误以为 VSCode 能“一键运行 wasm 文件”。
clang --target=wasm32-wasi 编译出的 .wasm 无法在浏览器直接 fetch
WASI 目标（wasm32-wasi）生成的模块依赖 WASI 系统调用，浏览器原生不支持。强行用 fetch + WebAssembly.instantiateStreaming 会报错：LinkError: import object field 'wasi_snapshot_preview1' is not a function。
- 要跑浏览器：必须用
wasm32-unknown-unknown（Rust）或emcc -s STANDALONE_WASM=1（Emscripten），禁用所有 host 依赖 - 要跑本地终端：用
wasmtime hello.wasm或wasmer run hello.wasm，但需确保wasmtime已加入PATH，且模块不含 JS glue code - 验证方式：运行
wabt的wasm-validate hello.wasm，若提示 “invalid import” 就说明目标平台不匹配
tasks.json 中 clang 路径写死导致 macOS/Linux 下找不到编译器
很多教程直接写 /opt/wasi-sdk/bin/clang，但实际解压位置可能在 ~/wasi-sdk 或 Homebrew 安装路径（如 /opt/homebrew/opt/wasi-sdk/bin/clang），硬编码会让构建任务失败，错误信息是：command 'clang' not found。
- 推荐做法：在 shell 中先确认路径，例如
which clang或find /opt -name clang 2>/dev/null - 更健壮的写法：用环境变量替代，比如把
WASI_SDK_PATH加入~/.zshrc，然后在tasks.json里写"${env:WASI_SDK_PATH}/bin/clang" - 别忽略
--sysroot：WASI 编译必须显式指定 sysroot，完整命令应类似：clang --target=wasm32-wasi --sysroot ${env:WASI_SDK_PATH}/share/wasi-sysroot ...
launch.json 配置 CodeLLDB 调试 wasm 时断点不命中
CodeLLDB 默认调试的是 native 二进制，不是 wasm 字节码；它只能调试 wasmtime 进程本身，而不是你的 wasm 函数逻辑。所谓“wasm 调试”，本质是调试运行时宿主（如 wasmtime）+ 源映射回溯，不是单步执行 local.get 指令。
- 必须开启 debug info：C 编译加
-g，Rust 编译加debug = true（Cargo.toml），否则.wasm里没有 DWARF 信息 - launch.json 中
program必须指向wasmtime（不是你的.wasm文件），args才传 wasm 路径，例如：["-g", "${workspaceFolder}/target/debug/hello.wasm"] - 断点只能打在 C/Rust 源码上，不能打在
.wat或.wasm上；VSCode 不解析 WAT 符号表，wat-lsp插件只做语法高亮，不提供调试能力
WebAssembly.instantiateStreaming 报 CORS 或 MIME 类型错误
浏览器加载 .wasm 时严格校验响应头：Content-Type 必须是 application/wasm，且服务端需允许跨域（开发时常见于用 file:// 直接打开 HTML）。
- 绝对不要双击 HTML 文件打开——这触发
file://协议，fetch 会被浏览器拦截，报错：TypeError: Failed to fetch - 必须起本地 HTTP 服务：用
npx serve、python3 -m http.server 8000或 VSCode 的 Live Server 插件 - 确保服务器返回正确 MIME 类型：Live Server 默认支持
.wasm，但自建服务需手动配置；Nginx 示例：types { application/wasm wasm; } - 路径别写错：
WebAssembly.instantiateStreaming(fetch("hello.wasm"))中的hello.wasm是相对当前 HTML 的路径，不是 VSCode 工作区根目录
最常被忽略的一点：WASI 和浏览器 wasm 是两套 ABI，混用工具链（比如用 wasi-sdk 编译后丢进网页）必然失败；选哪条路，得从第一行代码就决定——不是插件装得多就能跑起来。
