断点打不中需检查javascript调试器是否启用：确认运行配置为javascript debug类型、指向本地html文件、sourcemap正确生成加载、chrome devtools开启且未禁用断点、webstorm调试会话已启动、iframe/service worker上下文已配置监听、热更新后sourcemap同步。
断点打不中？检查是否启用了 JavaScript 调试器
WebStorm 默认不会自动启动 JS 调试环境，即使你点了 Debug 按钮，也可能只是跑起来了，没进调试状态。关键看右下角状态栏有没有出现 Debugger connected 或类似提示 —— 没有就等于断点白打。
- 确保运行配置是
JavaScript Debug类型（不是Node.js或npm），路径必须指向一个本地 HTML 文件（如index.html），且该文件能被 WebStorm 内置服务器访问（http://localhost:63342/...） - 如果用的是 Vite / Webpack Dev Server，别直接选 HTML，改用
Attach to Node.js/Chrome配置，然后手动在 Chrome 里打开chrome://inspect并连接 - 断点打在压缩后代码（如
bundle.js）上基本无效 —— 必须确保 sourcemap 已生成且被浏览器正确加载，检查 Network 面板里是否有.js.map文件返回 200
Chrome 调试时变量显示 undefined 或值滞后？看作用域和求值时机
这不是 WebStorm 的 bug，而是 V8 引擎的调试行为：变量只在当前执行帧（stack frame）内实时可读，跳出作用域或异步回调里，IDE 显示的可能是上一次快照，甚至无法读取闭包变量。
- 避免在
setTimeout、Promise.then或事件回调里依赖“悬停查看”变量值；改用console.log或在回调开头打个断点再看 - 函数参数名和局部变量名如果被 minify 工具重命名（如变成
a,t），WebStorm 无法还原原始语义 —— 开发阶段务必关掉构建工具的minify和mangle - 想查异步链中的某个中间值？右键变量 →
Evaluate Expression，输入await somePromise可强制等待并查看结果（仅限当前暂停位置）
debugger 语句没反应？检查是否被禁用或绕过
写了 debugger 却毫无反应，大概率是浏览器 DevTools 没开，或者 WebStorm 的调试会话根本没连上 Chrome。
- Chrome 地址栏输入
chrome://flags/#enable-devtools-experiments，开启实验性功能，再打开 DevTools → ⚙️ →Preferences → Debugger → Disable JavaScript breakpoints确保没勾选 - WebStorm 中按
Ctrl+Shift+F10（Windows/Linux）或Cmd+Shift+F10（macOS）运行的是Run，不是Debug—— 必须点虫子图标或按Ctrl+D启动调试会话 - 如果用了 Service Worker 或 iframe 加载脚本，
debugger可能落在独立上下文里，WebStorm 默认不监听 —— 需在Settings → Languages & Frameworks → JavaScript → Debugger中勾选Auto-enable debugging for iframes
修改代码后断点失效？热更新没同步 sourcemap
你在 WebStorm 里改了 app.js，保存，刷新页面，断点却跳到旧代码行 —— 这不是缓存问题，是构建工具输出的 sourcemap 没随代码更新，或者 WebStorm 没重新解析映射关系。
- Vite 用户：确认
vite.config.ts中build.sourcemap: 'inline'或'hidden'，避免生成外部.map文件导致路径错乱 - Webpack 用户：检查
devtool设为'eval-source-map'或'source-map'，别用'cheap-module-eval-source-map'（缺失列信息，断点不准） - 改完代码后，如果断点变灰（未激活），右键断点 →
More Options → Automatically reconnect to browser on reload打钩，否则每次刷新都要手动重连调试器
最麻烦的永远不是设断点，而是搞清当前这行 JS 到底是在哪个 bundle 里、由哪个 loader 处理、sourcemap 是谁生成的、Chrome 加载的是哪一版 —— 这些链条断一环，调试就成猜谜。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
