WebStorm中async/await断点失效，主因是误用Node.js/npm配置而非JavaScript Debug配置；必须选用JavaScript Debug类型、URL与浏览器地址完全一致，并确保sourceMap启用且.js.map文件正常加载。
断点打在 async/await 函数里没反应？检查是否用了 JavaScript Debug 配置
WebStorm 本身不执行 JS，只作为 Chrome 的调试客户端。async 函数断点失效，90% 是因为运行配置选错了——你很可能在用 Node.js 或 npm 类型配置调试前端代码。这类配置会去调试 Vite/Webpack 进程本身，而不是浏览器中运行的 async 函数。
必须改用 JavaScript Debug 配置，并确保 URL 指向实际页面地址（如 http://localhost:5173），不是本地文件路径或构建产物目录。
- 打开
Run → Edit Configurations…，点击+→ 选择JavaScript Debug -
URL必须和浏览器地址栏完全一致（协议、端口、路径一个都不能差） - 不要勾选
Use localhost自动端口（63342）——那是 WebStorm 内置服务器，和 Vite 不兼容 - 保存后，用绿色虫子图标（
Debug）启动，不是播放按钮（Run）
await 表达式断点被跳过？变量还没 resolve 就执行了
async 函数里设断点，比如在 const data = await fetch('/api') 下一行，但调试时直接跳过，常见原因是：该行尚未真正执行（Promise 还在 pending），或者断点位置无效（如空行、纯声明语句）。
更关键的是，V8 调试器对 await 后续逻辑的暂停时机有严格限制：它只在“可执行语句”上生效，且依赖 sourcemap 正确映射原始源码。
立即学习“Java免费学习笔记（深入）”；
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 断点优先设在
await后第一行可执行语句，例如console.log(data)或if (data.ok) { ... }，别设在const result = data.json()这类声明行 - 确保构建工具启用 sourcemap：
vite.config.ts中build.sourcemap = true，tsconfig.json中"sourceMap": true - 浏览器 Network 面板确认
.js.map文件返回 200，且未被缓存（强制刷新Ctrl+Shift+R） - 避免在
Promise.then()回调里设断点——异步链中作用域不稳定，IDE 可能读不到变量
调试 Promise 链中的中间值？用 Evaluate Expression 强制求值
想看 fetch().then(res => res.json()).then(data => data.items) 里 res.json() 的返回值，但断点没法卡在中间？悬停查看往往显示 undefined 或 Promise { <pending> }</pending>，这不是 WebStorm 的问题，而是 V8 调试协议的限制。
正确做法是：在已暂停的 async 函数断点处，右键变量或打开 Debug → Console，输入表达式手动触发。
- 在
await行暂停后，右键高亮的fetch(...)→Evaluate Expression，输入await fetch('/api').then(r => r.json()) - 若变量名被压缩（如
e、t），说明构建时没关minify—— 开发阶段务必禁用build.minify - Service Worker 或 iframe 加载的脚本需额外开启监听：在
Settings → Tools → JavaScript → Debugger → WebKit勾选Enable debugging for Service Workers和iframes
debugger 语句不生效？先确认 DevTools 是否连接成功
写了 debugger 却毫无反应，大概率是 WebStorm 根本没连上 Chrome。关键看右下角状态栏有没有 Debugger connected 提示，没有就等于整个调试通道没通。
即使插件装了、配置对了，Chrome 的实验性功能或设置也可能绕过断点。
- Chrome 地址栏输入
chrome://flags/#enable-devtools-experiments，开启实验性功能 - 打开 DevTools（
F12），点 ⚙️ →Preferences → Debugger，确认Disable JavaScript breakpoints没被勾选 - 检查
JetBrains IDE Support插件是否启用（右上角JB图标应为蓝色）；若灰掉，点击并允许访问此站点 - 热更新（HMR）后旧断点常失效——刷新页面或重启
vite serve后重设断点
dev 模式默认生成 sourcemap，但一旦加了 build.rollupOptions.output.manualChunks 等配置，map 文件路径可能错位，导致断点始终显示为“未绑定”。 
