断点不命中的首要原因是 source map 未生成或未加载；需在 Chrome DevTools Sources 面板展开 webpack:// 确认可见真实 .vue 文件，否则检查 vue.config.js 中 devtool 是否被覆盖为 'eval' 或缺失，并确保 Remote URL Mapping 路径精确匹配。
source map 没生成，断点必然失效
WebStorm 断点不命中的首要原因，90% 是 source map 根本没生成或没加载。Vue CLI 默认 dev 模式下虽设了 devtool: 'source-map'，但升级到 Vue CLI 5+ 或手动改过 vue.config.js 后，常被覆盖为 'eval' 或直接删掉——这种模式下 Chrome Sources 里只看到 app.js，看不到 /src/components/HelloWorld.vue。
验证方法：启动 npm run serve 后，打开 Chrome DevTools → Sources → 展开 webpack://，必须能看到真实 .vue 文件路径。若无，立刻检查：
-
vue.config.js中是否显式写了config.devtool = 'source-map'（注意包裹在if(process.env.NODE_ENV === 'development')内） - Vite 项目则确认
vite.config.ts中build.sourcemap为true（开发模式默认开启，但若改过build配置可能被关） - 检查生成的
index.html是否引用了.map文件，例如<script src="/js/app.js.map"></script>；没有就说明构建环节失败
Remote URL Mapping 配错一个字符，断点就找不到源文件
WebStorm 不靠文件名自动匹配，它依赖你手动配置的 Remote URL 映射，把浏览器运行时的 webpack:///src/components/Button.vue 对应回你本地的绝对路径。配错斜杠方向、大小写、多/少一个 /，断点就永远灰掉。
典型配置（Vue CLI 默认结构）：
立即学习“前端免费学习笔记（深入）”；
-
Local path填你本地src目录的**绝对路径**，Windows 也用正斜杠/，例如：/Users/you/my-vue-app/src -
Remote URL必须填webpack:///src（不是http://localhost:8080/src，也不是/src） - 若用了别名如
@/utils，额外加一条映射：Local path填/Users/you/my-vue-app/src/utils，Remote URL填webpack:///@/utils
入口路径：WebStorm → Preferences → Debugger → JavaScript → Remote URLs → Remote URL Mapping
JavaScript Debug 配置必须基于已运行的服务
不能直接 Debug 单个 .vue 文件，也不能用 Node.js 配置跑前端页面——必须用 JavaScript Debug 类型，并且确保服务已提前运行。
操作顺序不能颠倒：
- 先在终端或 WebStorm 的 npm 工具窗口中执行
npm run serve（或npm run dev），拿到实际地址（如http://localhost:8080/） - 再新建
JavaScript Debug配置，URL字段填上一步拿到的地址 - 点击 Debug 图标运行，WebStorm 才会连接已运行的服务，而非另起一套
如果点了 Debug 后弹出 about:blank，大概率是 Chrome 启动参数没设对：进 Settings → Tools → Web Browsers，勾选 Use custom Chrome executable，并在 Chrome 参数里加上 --remote-allow-origins=*
调试器连上了，但变量值显示 undefined 或类型推断不准
这通常不是断点问题，而是 IDE 对 Vue 语法的理解偏差。旧版 WebStorm 自带的 Vue.js 插件只支持 Options API，对 <script setup> 下的 defineProps、defineEmits 推断弱，甚至标红。
解决办法很明确：
- 卸载内置
Vue.js插件（Settings → Plugins） - 从 Marketplace 安装官方
Volar（注意不是Vue.js，也不是Vetur） - 同时启用
Vue Language Features (Volar)子插件 - 重启 WebStorm，确认状态栏右下角显示
Volar，且defineProps<{...}>()能正确解析类型
如果仍报红，检查项目根目录是否有 tsconfig.json，且含 "types": ["vue"] ——少了这一行，Volar 就无法识别 Vue 全局类型
