VS Code无法在Node中直接调试WebAssembly源码，但可通过wasmtime+wasm32-wasi+CodeLLDB实现本地断点调试；需编译时保留DWARF调试信息，Node本身不解析source map或DWARF，仅执行wasm字节码。

VS Code 无法在 Node 环境中直接调试 WebAssembly 源码（如 Rust/C 的 .rs/.c 文件），但可通过 wasmtime 或 wasmer + CodeLLDB 实现本地断点调试——前提是编译时保留 DWARF 调试信息，且 Node 不参与 wasm 加载过程。

Node 本身不支持 Wasm 源码级调试

Node.js 自 v18.16+ 原生支持 WebAssembly.instantiate 和 WebAssembly.compileStreaming，但它只加载并运行 wasm 字节码，不解析 .wasm.map、不读取 DWARF、不暴露源码行号。你在 VS Code 里对 .rs 或 .c 文件打的断点，Node 运行时完全无视。

常见错误现象：

• 断点呈灰色，提示 “Unbound breakpoint”
• 调试器启动后立即退出，或卡在 require('fs') 类 Node 内部调用上
• 即使 console.log 输出 wasm 函数返回值，也无法单步进入原始逻辑

wasmtime + CodeLLDB 是当前最可行的 Node 替代方案

如果你的目标是像调试 C/Rust 那样查看变量、调用栈、单步执行，必须绕过 Node，改用 WASI 兼容运行时，并让 VS Code 通过 LLDB 协议连接。关键不是“在 Node 里调试 wasm”，而是“用 wasm 工具链生成可调试的 wasm，再用本地调试器加载它”。

实操要点：

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 用 cargo build --target wasm32-wasi --debug 编译（不是 wasm32-unknown-unknown）；确保 Cargo.toml 中 [profile.dev] debug = true
• 安装 wasmtime CLI：curl https://wasmtime.dev/install.sh -sSf | bash，并确认 wasmtime --version 可执行
• VS Code 安装 CodeLLDB 扩展（非 JavaScript Debugger）
• 在 .vscode/launch.json 中配置：

  {
    "type": "lldb",
    "request": "launch",
    "name": "Debug WASI",
    "program": "wasmtime",
    "args": ["--debug", "--invoke", "main", "${workspaceFolder}/target/wasm32-wasi/debug/your_app.wasm"],
    "cwd": "${workspaceFolder}"
  }

• 确保 your_app.wasm 文件里嵌入了 DWARF（可用 wabt 的 wasm2wat --debug-names your_app.wasm 验证）

为什么不能用 Node + source map 调试？

因为 Node 的 V8 引擎在加载 wasm 时不触发 source map 解析流程，也不向调试器暴露 wasm 指令与高级语言源码的映射关系。Chrome DevTools 支持 wasm 调试，是因为它专为浏览器环境实现了完整的 DWARF 解析和 UI 渲染；Node 没有这层能力。

你可能会看到这些误导性配置：

• 在 launch.json 中设 "type": "node" 并指向一个 index.js，里面调用 WebAssembly.instantiate —— 这只会调试 JS 层，wasm 内部仍是黑盒
• 把 .wasm.map 放在同目录、加 //# sourceMappingURL=xxx.wasm.map 注释 —— Node 完全忽略该注释
• 启用 node --inspect 并在 Chrome DevTools 的 Sources 面板里找 .rs 文件 —— 它不会出现

如果必须走 Node 流程，唯一可观测方式是胶水层日志

当 wasm 模块由 wasm-pack build --target nodejs 生成时，它会输出 pkg/*.js 和 pkg/*.wasm。此时你可以：

• 在 JS 胶水代码中插入 console.log，观察传入参数和返回值
• 用 node --inspect-brk index.js 启动，在胶水函数入口/出口设断点
• 配合 WebAssembly.Module.customSections 提取自定义段（如 producers），验证构建是否含调试元数据
• 但注意：wasm-pack --target nodejs 默认不生成 .wasm.map，需手动加 --debug 参数并检查输出

真正复杂的逻辑调试，仍得退回 wasmtime + CodeLLDB。容易被忽略的一点是：wasm32-wasi 和 wasm32-unknown-unknown 是两个 ABI 完全不兼容的目标，切勿混用——前者用于本地 CLI 调试，后者专为浏览器设计。