断点停在bundle.js且变量名是_a、行号错位，根本原因是source map未被正确解析或路径映射失败；需确认浏览器是否加载了.map文件、检查sourceMappingURL注释、核对outFiles路径、webRoot与sourceMapPathOverrides配置，并确保Chrome启用source maps。
断点打在 bundle.js 上、变量名是 _a、行号错位——不是 VSCode 配置漏了字段，而是 source map 根本没被正确解析或映射路径对不上。
检查浏览器是否真加载了 source map
VSCode 不自己加载 .map 文件，它依赖 Chrome DevTools 的实际行为。断点灰掉前，先确认浏览器有没有真正拿到 map：
- 打开 Chrome DevTools →
Sources面板 → 刷新页面 → 展开webpack://或app://域名树，看到源码结构才算成功；如果只有top/下的压缩 JS，说明 map 没加载 - 切到
Network面板，过滤.map，看请求是否返回200；404表示开发服务器没暴露 .map 文件（比如 Vite 的vite preview默认不带 map） - 打开编译后的
index.js，末尾必须有且仅有一行：//# sourceMappingURL=index.js.map；路径要是相对路径（如./index.js.map），不能是/dist/index.js.map或拼写错误
launch.json 中 outFiles 必须指向编译产物，不是源码
outFiles 是 VSCode 查找 .map 的起点，填错就等于告诉调试器“去错地方翻地图”：
- TS 项目编译到
dist/，就写：["${workspaceFolder}/dist/**/*.js"]；若输出多格式（如dist/es/+dist/lib/），得列全：["${workspaceFolder}/dist/es/**/*.js", "${workspaceFolder}/dist/lib/**/*.js"] - Vue CLI 项目默认输出在
dist/，但若改过outputDir，outFiles必须同步；Vite 用户注意：vite build默认关闭 sourcemap，必须显式设build.sourcemap: true - Webpack 用户慎用
devtool: 'hidden-source-map'——它生成 map 但不写sourceMappingURL注释，VSCode 和 Chrome 都找不到
webRoot 和 sourceMapPathOverrides 决定路径怎么拼
就算 .map 文件存在，里面 sources 字段的路径（如 webpack:///src/App.vue）也得能映射回你本地真实文件位置：
-
webRoot是基准目录，通常填"${workspaceFolder}"；但如果 HTML 入口在public/index.html且服务根路径是dist/，就得设为"${workspaceFolder}/dist"，否则webpack:///src/会拼成dist/src/找不到 - Vite / Webpack 项目常需
sourceMapPathOverrides修正协议前缀："webpack:///./src/*": "${webRoot}/src/*"；少一个/或*，断点就变空心 - 多包项目（如
packages/foo/src）容易漏映射，加一行："resolveSourceMapLocations": ["${workspaceFolder}/packages/**/src/**", "!**/node_modules/**"]
Chrome 自己关了 source map，VSCode 配再好也没用
VSCode 的前端调试本质是复用 Chrome DevTools 协议，不是纯本地行为：
- Chrome 设置里必须打开：
Settings → Preferences → Sources → Enable JavaScript source maps - 调试配置中
type必须是"pwa-chrome"（v4.12+ 插件已弃用旧"chrome"类型），且确保已安装最新版Debugger for Edge或Debugger for Chrome - 别复用旧调试会话：每次改完配置，先停掉当前调试，再点
Start Debugging；旧进程还拿着老符号表，变量名永远是_a
最常被忽略的是：.map 文件时间戳没更新，或者构建命令根本没重新跑（比如只改了 launch.json 就按 F5）。执行 ls -l dist/*.js.map 看文件修改时间，比猜快得多。
