90%断点无效是source-map未链上或webstorm找不到源码：检查source-map是否生成并加载、chrome sources中是否存在webpack:///src/路径、webstorm的remote url配置是否精确匹配、jetbrains ide support插件是否启用且配置正确、调试启动顺序是否为先运行npm start再点调试。
断点“点了没反应”，90% 是 source-map 没链上，或者 WebStorm 找不到你写的源码位置——不是 React 本身的问题，而是调试通路断了。
确认 source-map 已生成且浏览器能加载
Create React App 默认开启 devtool: 'source-map'，但一旦你在 package.json 里加了 "GENERATE_SOURCEMAP=false"，或改过 webpack.config.js（比如用了 Vite、Rspack 或自定义配置），它就悄无声息地关掉了。
打开 Chrome DevTools → Sources 标签页 → 左侧文件树里找有没有 webpack:///src/ 开头的路径；没有？说明 source-map 根本没加载成功。
常见干扰项：
-
cheap-module-source-map和eval-source-map在 WebStorm 中兼容性较差，优先试source-map或inline-source-map - 用 Vite 的项目默认不带
webpack:///前缀，WebStorm 会找不到源码，得手动配 URL 映射 - 构建产物里如果缺失
.map文件（比如被.gitignore拦了），也会导致映射失败
WebStorm 调试配置中 Remote URL 必须精确匹配
这个值不是你浏览器访问的地址，而是 source-map 里声明的“源码所在位置”。CRA 项目必须填 webpack:///src（注意结尾不加斜杠），少一个字符、多一个空格，断点就永远进不来。
如果你用的是 Vite 或其他工具，可能看到的是 file:/// 或 http:// 开头的路径，就得按实际 sourcesContent 或 sources 字段来配。可在 DevTools → Sources → 右键某个 JS 文件 → Reveal in Sidebar 看它在树里的真实路径前缀。
还要检查：.idea/workspace.xml 里可能残留旧的映射规则，临时删掉整个 .idea 目录再重开项目，比手动修 XML 更可靠。
JetBrains IDE Support 插件必须启用且匹配浏览器实例
这个插件不是可选项，是硬依赖——哪怕你用 Edge 或 Firefox，也得靠 Chrome 配合调试，因为 WebStorm 的 JS Debugger 底层只稳定支持 Chrome 的远程调试协议。
去 Chrome 网上应用店装 JetBrains IDE Support，装完右上角图标必须是亮起状态（灰色 = 未启用）；如果图标灰了，点进去检查是否勾选了“允许访问文件网址”和“在隐身模式下启用”。
关键细节：
- WebStorm 启动调试时，会自动拉起一个**全新 Chrome 进程**（带
--remote-debugging-port=63342参数），它不共享你日常用的 Chrome 用户数据目录，所以书签、插件、登录态全都没有 - 不要试图让 WebStorm 去 attach 已存在的 Chrome 窗口——它做不到；也不要自己手动在那个新窗口里装插件，每次重启都会清空
- 如果插件已启用但断点仍不命中，试试在地址栏输入
chrome://extensions/?id=hdokiejnpimakedhajhdlcegeplioahd直接跳转到插件页，强制刷新一次
启动顺序和代码一致性最容易被忽略
WebStorm 的调试配置里，千万别勾选 Before launch: npm start。必须手动先运行 npm start（或点 package.json 里的 start 按钮），等页面真正渲染出来（http://localhost:3000 能看到内容），再点虫子图标启动调试。
否则你会遇到两种典型失效场景：
- 页面还没起来，调试器就尝试注入，结果连不上
- 热更新后组件被重新 mount，但断点还挂在旧模块副本上（尤其
React.memo、React.lazy或自定义 Hook 内部），此时必须刷新页面才能同步上下文
最后验证方式很简单：在代码里直接写一行 debugger;，看 WebStorm 是否停住。如果 debugger 有效但断点无效，问题一定出在 source-map 映射或 URL 配置上；如果 debugger 也不生效，那基本是插件没启、端口被占、或 Chrome 实例根本没走调试通道。
