vscode无法自动重载chrome扩展，需依赖chrome手动重载或web-ext工具监听变更；调试需正确配置sourcemap、路径映射及chrome远程调试端口，且扩展生命周期特性决定完全无缝热更新不可行。
VSCode 本身不能直接“调试 Chrome 插件源码”或“监听扩展源码变更并自动重载”，它只提供编辑、断点设置和调试协议桥接能力；真正起作用的是 Chrome 的扩展加载机制、DevTools 协议、以及你是否手动触发了重载或配置了自动化流程。
Chrome 扩展必须手动重载才能看到代码变更
每次修改 manifest.json、background.js、content.js 或 popup.html 后，VSCode 不会自动刷新 Chrome 中的扩展。Chrome 不监听文件系统变化，也不支持热更新。
- 最简方式：打开
chrome://extensions→ 找到你的扩展 → 点击“重新加载”按钮（带循环图标的那个） - 若修改了
manifest.json字段（如version或权限），必须点击“重新加载”，否则变更不生效 - 仅修改
popup.js或options.js时，有时可直接右键弹出页 → “检查” → 刷新 DevTools 面板，但 background/service worker 仍需全局重载
用 web-ext 实现保存即重载（推荐）
web-ext 是 Mozilla 提供的命令行工具，但对 Chrome 扩展同样有效，它能监听文件变更并自动重载扩展，比手动点“重新加载”快得多。
- 安装：
npm install -g web-ext - 在项目根目录运行：
web-ext run --source-dir ./ --target=chrome - 它会启动一个独立 Chrome 实例（带干净 user-data-dir），并监听所有文件变更，保存即重载
- 注意：
web-ext不读取你当前 Chrome 的配置或扩展，所以调试 popup/background 时需用它启动的窗口 - 若想复用已有 Chrome 窗口，得配合
--start-url和自定义--user-data-dir，但容易冲突，不建议新手折腾
launch.json 配置对 Chrome 扩展调试基本无效
VSCode 的 Debugger for Chrome 扩展（或新版 pwa-chrome）的 launch.json 主要用于调试网页应用，不是为扩展设计的。它无法启动扩展、无法加载 background 或注入 content script。
- 你无法用
"request": "launch"自动打开带扩展的 Chrome 并跳转到某页面——除非你额外加--load-extension=...参数，但 VSCode 不原生支持传参给 Chrome 启动命令 - 调试 background service worker 只能靠
chrome://extensions页面里的 “inspect views: service worker” 手动打开 DevTools，然后在 VSCode 中用Attach to Process模式连接（需确保 Chrome 启动时带--remote-debugging-port=9222） - 调试 popup 页面更简单：右键扩展图标 → “检查弹出内容”，VSCode 会自动识别并映射断点（前提是已开启
sourceMaps: true且路径匹配）
Source map 失效是断点不命中的最常见原因
如果你用构建工具（如 Webpack、Rollup）打包扩展脚本，sourceMaps 配置错一点，断点就只会停在 bundle.js 里，而不是你写的 background.ts 或 content.ts 上。
- 确保构建配置中开启了
devtool: 'source-map'（Webpack）或等效选项 - 在
manifest.json中，background.service_worker或content_scripts指向的 JS 文件路径，必须与构建后实际输出路径一致 - VSCode 调试器依赖
webRoot和sourceMapPathOverrides做路径映射；例如，若构建后 source map 声明webpack:///./src/background.ts，而你源码在${workspaceFolder}/src/background.ts，就得配："webpack:///./src/*": "${workspaceFolder}/src/*" - 没配对？断点灰色、hover 显示 “Unbound breakpoint”、控制台报
Could not load content for ...
真正的难点不在 VSCode 设置，而在 Chrome 扩展生命周期本身：background service worker 是事件驱动、无常驻上下文的；content script 注入时机受 run_at 和页面 DOM 状态影响；popup 是按需加载的 iframe。这些特性决定了“实时监听→自动重载→立刻调试”根本做不到完全无缝——你得接受一部分手动操作，把精力放在理清执行时机和日志定位上。
