寻求VS Code中调试.wat文件的方案，兼容Wasmtime及跨平台

一、基于Wasmtime的原生调试配置 #

前置准备 #

• 确保已安装Wasmtime（Mac：brew install wasmtime；Windows：官网下载对应架构安装包或用choco install wasmtime）
• 安装WABT工具集（用于编译.wat到带调试信息的.wasm）：Mac用brew install wabt，Windows从官网下载解压后添加到环境变量
• 安装VS Code的WebAssembly扩展（提供.wat语法高亮和基础调试支持）

步骤 #

1. 编译.wat到带调试信息的.wasm：

   wat2wasm your-file.wat -o your-file.wasm --debug
   

2. 在项目根目录创建.vscode/launch.json，添加以下配置：

   {
     "version": "0.2.0",
     "configurations": [
       {
         "type": "wasmtime",
         "request": "launch",
         "name": "Launch Wasmtime Debug",
         "program": "${workspaceFolder}/your-file.wasm",
         "args": [],
         "cwd": "${workspaceFolder}"
       }
     ]
   }
   

3. 在.wat文件中设置断点，点击VS Code调试面板的启动按钮即可开始调试，支持单步执行、查看变量等操作。

二、CodeLLDB + Wasmtime 调试修正方案（解决你之前配置失败的问题） #

前置准备 #

• 安装最新版的CodeLLDB VS Code扩展
• 确保Wasmtime和WABT已安装（同上）

针对Apple Silicon Mac的配置 #

创建.vscode/launch.json：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "lldb",
      "request": "launch",
      "name": "LLDB + Wasmtime Debug",
      "program": "wasmtime",
      "args": ["run", "--debug", "${workspaceFolder}/your-file.wasm"],
      "cwd": "${workspaceFolder}",
      "targetArchitecture": "arm64",
      "sourceMap": {
        "/": "${workspaceFolder}"
      }
    }
  ]
}

针对Windows的配置 #

仅需修改targetArchitecture为x86_64，其余配置一致：

"targetArchitecture": "x86_64"

关键注意点 #

• 必须用wat2wasm --debug编译.wasm，否则LLDB无法关联.wat源码
• 确保.wat文件与编译后的.wasm在同一目录，或通过sourceMap正确映射源码路径

三、调试技巧 #

• 在.wat文件中直接点击行号设置断点，调试时会自动命中
• 调试过程中可通过VS Code的变量面板查看Wasm内存、寄存器状态
• 若遇到断点不命中，检查Wasmtime版本是否为最新（旧版本可能存在调试兼容性问题）

内容的提问来源于stack exchange，提问作者Troels Lund