根本原因是Node.js默认不加载DWARF调试段，必须显式启用--experimental-wasm-dwarf（≥18.17.0）并配置NODE_OPTIONS="--enable-source-maps"，且WASI模块因缺乏原生WASI实现无法用type:"node"调试。
Node.js 调试 Wasm 模块时为什么断点不命中
根本原因不是 VSCode 配置错了，而是 Node.js 默认不加载 DWARF 调试段，且必须显式启用实验性支持才能解析 .wasm 中的调试信息。
你写的 Rust 或 C 代码编译出带 -g 的 .wasm 文件后，Node.js 仍会忽略其中的 DWARF 数据——除非加运行参数：
-
node --experimental-wasm-dwarf（Node.js ≥18.17.0，稳定可用） - 若用
launch.json，必须写进runtimeArgs字段，不能只写在终端命令里 - 旧版 Node.js（如 16.x）即使加 flag 也无效，必须升级；检查版本用
node -v - Rust 用户注意：
cargo build --target wasm32-unknown-unknown -Z unstable-options --codegen debuginfo=2才生成完整 DWARF，wasm-pack build -d不够
launch.json 怎么配才能让 Node.js 正确加载并调试 .wasm
VSCode 的 node type 调试器不直接加载 .wasm，它调试的是 JS 入口文件（比如 index.js），而该文件负责 WebAssembly.instantiate()。所以配置核心是：JS 文件可断、Wasm 模块可符号解析、调试器能穿透到 Wasm 层。
关键字段示例（适用于 Rust + wasm-bindgen 项目）：
{
"version": "0.2.0",
"configurations": [{
"type": "node",
"request": "launch",
"name": "Debug Wasm in Node",
"program": "${workspaceFolder}/index.js",
"runtimeArgs": ["--experimental-wasm-dwarf"],
"env": {
"NODE_OPTIONS": "--enable-source-maps"
},
"skipFiles": ["<node_internals>/**"]
}]
}-
program必须指向 JS 入口，不是.wasm文件路径 -
NODE_OPTIONS="--enable-source-maps"是必须项，否则node --experimental-wasm-dwarf无法关联源码 - 如果 JS 入口用了
fs.readFileSync加载.wasm字节码，确保路径正确；用import动态导入时，Webpack/Vite 等打包器需开启devtool: 'source-map' - 不要在
launch.json里写"console": "integratedTerminal"，它会干扰调试器对 Wasm 符号的捕获
浏览器环境调试 Wasm 时为什么 source map 失效
失效不是插件问题，而是构建产物和加载方式不匹配：浏览器 DevTools 只认 HTTP 响应头中的 SourceMap 字段或 JS 中的 //# sourceMappingURL= 注释，且 .wasm.map 必须可被同源请求获取。
常见断裂点：
-
wasm-pack build --dev --target web生成的.wasm.map默认放在pkg/下，但 Web 服务器没把pkg/设为静态资源根目录 → 浏览器 404 加载 map 文件 - 用了
WebAssembly.instantiateStreaming()：该 API 不读取sourceMappingURL注释，必须改用WebAssembly.instantiate()+fetch().then(r => r.arrayBuffer()) - Chrome 设置里没勾选
Enable WebAssembly source maps（路径：DevTools → Settings → Preferences → Sources） - 源码路径映射错位：Rust 编译时工作目录是
src/lib.rs，但 map 文件里写的是/home/user/project/src/lib.rs→ 需在launch.json中用sourceMapPathOverrides重映射
WASI 模块能在 Node.js 里直接调试吗
不能。WASI 模块（如 wasm32-wasi 目标）依赖 WASI 系统调用接口，Node.js 原生不提供 wasi_snapshot_preview1 实现，node --experimental-wasm-dwarf 也仅支持浏览器 ABI 兼容模块（wasm32-unknown-unknown）。
想调试 WASI 模块，只能换执行器：
- 用
wasmtime：安装后运行wasmtime --debug --mapdir .:. your_module.wasm，它支持 DWARF 并可连接 VSCode 的lldb插件 - 用
wasmer：启动时加--inspect参数，再通过 Chrome DevTools 调试（类似 Node.js 的--inspect） - VSCode 里没有开箱即用的 WASI 调试配置，
launch.json的type: "node"对 WASI 模块完全无效 - 别试图用
emrun或node强行加载 WASI 模块——会报LinkError: import object field 'wasi_snapshot_preview1' is not a function
真正容易被忽略的点是：Wasm 调试不是“装个插件就通”，它卡在工具链、目标 ABI、运行时能力三者是否对齐。哪怕 node -v 显示 20.x，只要没启用 --experimental-wasm-dwarf，或者没配 NODE_OPTIONS，断点就永远灰着。
