空心圆表示VS Code识别断点但未加载源码,主因是launch.json中"type"(须为"pwa-chrome")、"url"(须与浏览器地址栏完全一致)和"webRoot"(须指向源码根目录)三处硬匹配失败。

断点是空心圆?三处硬匹配没对齐
空心圆 = VS Code 知道你点了断点,但根本没加载到原始源码。90% 是 launch.json 里三个字段和运行环境不一致:
-
"type"必须是"pwa-chrome"(不是"chrome",不是"pwa-edge",旧版插件已废弃) -
"url"必须和浏览器地址栏**完全一致**:协议(http://,不能是file://)、端口(:5173)、路径(/login末尾有无斜杠)、哈希(#home)都得一模一样 -
"webRoot"必须指向你编辑的源码根目录,比如"${workspaceFolder}";若项目结构是src/写代码、dist/部署,但你在dist/index.html里引用./js/app.js,那webRoot还得设成"${workspaceFolder}/src"并配sourceMapPathOverrides
Chrome 启动失败?命令行 + 独立用户数据目录是刚需
双击图标打开的 Chrome 默认关闭远程调试协议,VS Code 连不上就会卡在 Could not connect to localhost:9222。这不是配置问题,是 Chrome 根本没暴露接口。
- 先关掉所有 Chrome 进程:
taskkill /f /im chrome.exe(Windows)或pkill -f "chrome.*9222"(macOS/Linux) - 用命令行启动:
chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug(--user-data-dir是必须的,否则拒绝以调试模式复用主配置) - 如果
9222被占,可换为9223,但仅在"request": "attach"模式下才需同步改"port"字段
插件装错了?Debugger for Edge 才是唯一正确选择
旧版 Debugger for Chrome 插件已彻底废弃,VS Code 1.80+(2025 年后所有稳定版)只认 "type": "pwa-chrome",而这个类型由 Debugger for Edge 扩展提供支持。装错就静默失败,连错误提示都不给。
- 卸载所有名称含
Chrome Debugger、legacy或版本号带v4.x的插件 - 在 VS Code 扩展市场搜索并安装
Debugger for Edge(发布者必须是 Microsoft) - 安装后右下角状态栏应显示“
Debugger for Edge 已启用”
source map 加载失败?构建配置和映射规则要双向验证
断点停在 dist/ 文件里、变量名变成 _a、调用栈显示压缩后路径——这些都不是 VS Code 故障,而是 source map 没生效。
立即学习“前端免费学习笔记(深入)”;
- Webpack 项目确保
devtool: 'source-map'或更稳的'inline-source-map' - Vite 项目检查
build.sourcemap: true(开发模式默认开启,但build后需手动配) - 检查输出目录中是否存在
.map文件(如main.js.map),且其内容包含有效的sources字段 - 在
launch.json中添加"sourceMaps": true和精确的"sourceMapPathOverrides",例如:"webpack:///./src/*": "${webRoot}/src/*"
launch.json 里的映射规则。


















