VSCode本身不运行WebAssembly，仅调用emcc编译、启动服务并连接Chrome调试器；能否成功取决于Emscripten路径、参数（-g、-O0、--source-map-base）及调试链路是否全部对齐，且需确保emcc在终端可执行、tasks.json用emcc而非clang、launch.json匹配服务地址与webRoot。
VSCode 本身不运行 WebAssembly，它只负责调用 emcc 编译、启动本地服务、连接 Chrome 调试器——能否跑起来，取决于你是否把 Emscripten 的路径、参数和调试链路全对齐。
确认 emcc 在 VSCode 终端里能直接执行
很多卡在“找不到命令”的人，其实是没让 VSCode 继承 shell 的环境变量。Emscripten 激活后生成的 emsdk_env.sh（或 emsdk_env.bat）必须被正确加载。
- 在 macOS/Linux 上：打开 VSCode 前，先在终端执行
source ./emsdk/emsdk_env.sh；或者把这行加到~/.zshrc末尾，再重启 VSCode - 在 Windows 上：用 PowerShell 启动 VSCode（不是快捷方式），确保已运行过
emsdk_env.ps1 - 验证方式：在 VSCode 内置终端输入
emcc -v，应输出版本号；若报command not found，说明路径没导进去
tasks.json 必须用 emcc，不能用系统 clang
用 clang 直接编译 C 文件生成 .wasm，浏览器会报 LinkError: import object field 'env' is not a Function ——因为普通 clang 不生成 Emscripten 兼容的导入表和内存模型。
- 正确写法（
tasks.json中）："command": "emcc"，不是"command": "clang" - 关键参数必须包含：
-g（生成 DWARF 调试信息）、-O0（关优化，否则断点失效）、--source-map-base http://localhost:8080/（告诉浏览器从哪加载.wasm.map） - 示例命令：
emcc -g -O0 --source-map-base http://localhost:8080/ add.c -o add.js——注意输出是.js，不是.wasm；Emscripten 默认生成 JS 胶水代码 + .wasm + .map 三件套
launch.json 要匹配 emrun 或 Live Server 启动方式
VSCode 调试器不直接加载 .wasm，而是通过浏览器加载 HTML 页面，再由页面里的 JS 加载并实例化模块。所以 launch 配置得对应你的运行方式。
- 如果用
emrun（推荐）："type": "pwa-chrome"+"request": "launch"+"url": "http://localhost:8080"，同时确保emrun add.js已启动服务 - 如果用 Live Server 插件：
"url": "http://localhost:5500"，但要手动把add.js和add.wasm放进根目录，并在 HTML 里显式import('./add.js') - 常见坑：
webRoot必须设为项目根目录（如"${workspaceFolder}"），否则 Chrome 找不到源码映射路径
调试时看不到源码？检查 .wasm.map 是否被加载
Chrome DevTools 的 Sources 面板里看不到 C 源文件，不是插件问题，而是 .wasm.map 没被正确请求或 404。
- 打开 Chrome Network 面板，过滤
.map，看是否发起请求且返回 200；若 404，检查--source-map-base地址是否与实际服务地址一致 -
.wasm.map文件必须和.wasm同目录，且服务器需支持静态文件服务（emrun自带，Live Server 默认支持） - 别忽略
add.js里的注释行：//# sourceMappingURL=add.js.map——它指向的是 JS 的 sourcemap，而 Wasm 的源码映射靠的是.wasm.map，两者不同
最常被跳过的环节是：没验证 emcc -g 输出里是否真有 add.wasm.map 文件，以及没确认 Chrome 是否真的发出了对它的 GET 请求。调试失败往往就卡在这一步，而不是配置本身。
