F5启动复合调试、F9设断点、F10/F11单步是基础，真正影响Wasm调试效率的是Ctrl+K Ctrl+I悬停查变量、Ctrl+Shift+Y打开调试控制台，以及launch.json中必须配准的sourceMapPathOverrides路径映射规则。
哪些快捷键对Wasm调试真正有用
VSCode 本身不执行 Wasm，但调试流程高度依赖快捷键联动。F5 启动、F9 打断点、F10/F11 单步这些基础键位必须可用，但仅靠它们远远不够——Wasm 调试的特殊性在于源码映射和跨层跳转，需要额外绑定几个关键操作。
真正影响效率的是这三组：
-
F5：必须绑定到 compound launch（比如Full Stack Debug），不能只启动 Chrome 或只 attach Node；否则 .rs/.cpp 源文件里的断点根本不会被识别 -
Ctrl+K Ctrl+I（悬停查看变量值）：Wasm 变量在 DevTools 中常显示为__wbindgen_...乱码，但在 VSCode 悬停时能还原原始名（前提是.wasm.map加载成功且路径映射正确） -
Ctrl+Shift+Y（打开调试控制台）：比 DevTools Console 更可靠——Wasm 实例的exports对象、memory.buffer字节长度、甚至WebAssembly.Global值都能在这里直接console.log输出，避免反复切 Tab
launch.json 里必须配的 sourceMapPathOverrides
断点灰色、点击无效，90% 是 sourceMapPathOverrides 没对上。它不是可选项，是硬性路径翻译规则，浏览器加载的源路径（来自 .wasm.map）和你本地文件系统路径必须严格映射。
Rust 项目常见错误配置："webpack:///./src/*": "${webRoot}/src/*" —— 这个只在用 webpack 构建时有效。如果你用 wasm-pack build --target web 直出，没走 webpack，那 .wasm.map 里写的源路径通常是 file:///xxx/src/lib.rs 或 webpack:///src/lib.rs，得改成：
-
"*": "${webRoot}/*"（最宽松，适合小项目快速验证） -
"file:///*": "${webRoot}/*"（更精确，匹配 file:// 协议路径） - 如果用 Emscripten 编译 C/C++，且
.wasm.map里源路径含/home/user/project/，就得写成"/home/user/project/*": "${webRoot}/*"
tasks.json 编译任务要带 --debug 且禁用优化
wasm-pack build 或 emcc 不加 --debug 或 -g -O0，生成的 .wasm 就没有调试符号，VSCode 再怎么配也看不到源码行号。
对应配置要点：
- Rust：
"command": "wasm-pack", "args": ["build", "--target", "web", "--debug"]—— 必须用wasm-pack，别用cargo build --target wasm32-unknown-unknown，后者不生成.wasm.map也不打包 JS 绑定 - C/C++：
"command": "emcc", "args": ["-g", "-O0", "--source-map-base", "http://localhost:8000/", "add.c", "-o", "add.wasm"]——-O0关优化是刚需，-g生成 DWARF，--source-map-base告诉浏览器从哪拉.wasm.map - 务必在
presentation里设"clear": true，否则编译报错被刷屏，看不到undefined symbol: __wasi_proc_exit这类关键提示
容易被忽略的环境启动方式
macOS 和 Windows 用户最容易栽在这一步：VSCode 从 Dock 或开始菜单启动时，内置终端压根读不到 shell 的 $PATH，导致 wasm-pack 或 emcc 报 command not found，tasks.json 直接失效。
解决方法只有一个：别点图标，用终端启动。
- macOS：
source $HOME/.cargo/env && code .（Rust）或source ./emsdk_env.sh && code .（Emscripten） - Windows：
emsdk_env.bat && code .（cmd）或.\emsdk_env.ps1; code .（PowerShell，需先Set-ExecutionPolicy RemoteSigned -Scope CurrentUser） - 验证是否生效：Ctrl+` 打开终端，直接运行
wasm-pack --version或emcc --version，有输出才算到位
路径映射不对、编译没带调试信息、终端 PATH 失效——这三个点卡住，VSCode 就永远只是个高级文本编辑器，而不是 Wasm 调试入口。
