VSCode可原生调试浏览器扩展：需配置launch.json、启用开发者模式加载解压版扩展、Edge需装Debugger插件、background script需事件触发断点、Chrome/Edge 120+支持manifest.json中debuggable字段。
如果您在开发浏览器扩展程序时需要检查代码执行流程、查看变量值或定位错误，VSCode 提供了原生支持的调试能力。以下是实现该目标的具体操作路径：
本文运行环境：MacBook Pro，macOS Sequoia。
一、配置 launch.json 启动项
VSCode 通过 launch.json 文件定义调试会话的启动参数，需为浏览器扩展指定正确的调试类型与运行时环境。该配置使 VSCode 能连接到已加载扩展的浏览器实例。
1、在项目根目录下创建 .vscode 文件夹（若不存在）。
2、在 .vscode 文件夹中新建 launch.json 文件。
3、填入以下内容（以 Chrome 为例）：
4、确保 "request" 字段值为 "launch"，"type" 为 "pwa-chrome"，"url" 指向扩展的 popup.html 或 background.html 页面路径。
5、设置 "webRoot" 为源码所在目录，例如 "${workspaceFolder}"。
二、启用扩展的开发者模式并加载解压版
浏览器必须以可调试方式加载扩展，即通过“加载已解压的扩展程序”功能引入本地代码，并开启开发者工具权限。此步骤确保断点可被识别且调试器能注入脚本上下文。
1、打开 Chrome 浏览器，访问 chrome://extensions/。
2、开启右上角的“开发者模式”开关。
3、点击“加载已解压的扩展程序”按钮。
4、选择扩展项目的 manifest.json 所在文件夹。
5、确认扩展图标出现在地址栏右侧，且状态显示为“已启用”。
三、使用 Debugger for Edge 插件调试 Edge 扩展
当目标浏览器为 Microsoft Edge 时，需借助官方推荐的调试器插件替代默认 Chrome 调试器。该插件提供 Edge 特有 API 的完整支持与更准确的源映射解析。
1、在 VSCode 扩展市场中搜索并安装 Debugger for Edge。
2、在 launch.json 中新增一个配置对象，将 "type" 设为 "pwa-msedge"。
Node.js 可靠编程技能。避免事件循环阻塞、异步陷阱、ESM 兼容问题和内存泄漏。触发词：Node.js 开发、async/await、流处理、性能优化、安全编码。
3、设置 "runtimeExecutable" 为 "msedge" 或 Edge 安装路径（如 "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge"）。
4、指定 "url" 为扩展的入口页面，例如 "chrome-extension://your-extension-id/popup.html"。
5、启动调试会话前，确保 Edge 已关闭所有实例，避免端口占用冲突。
四、在 background script 中设置断点并触发调试
background script 是扩展长期运行的核心逻辑，其调试依赖于事件触发机制。直接启动后不会立即停在断点，需模拟对应事件（如安装、消息接收、定时任务）激活脚本执行。
1、在 background.js 或 background.ts 文件中任意行左侧灰色区域单击，设置断点。
2、重启浏览器或重新加载扩展，使 background script 重新初始化。
3、打开 chrome://extensions/ 页面，找到对应扩展，点击“详情”，再点击“背景页”链接。
4、在打开的 DevTools 中刷新页面，或发送一条 runtime.sendMessage 消息触发监听函数。
5、此时 VSCode 将自动捕获执行流并在断点处暂停，可查看作用域变量、调用堆栈及表达式求值。
五、使用 manifest.json 的 debuggable 属性启用高级调试支持
Chrome 120+ 和 Edge 120+ 支持在 manifest.json 中声明 "debuggable" 字段，显式允许外部调试器连接至 service worker 类型的 background script。该字段可绕过部分自动注入限制，提升断点命中率。
1、打开 manifest.json 文件。
2、在 background 对象内添加 "debuggable": true 字段。
3、确保 background.type 为 "service_worker"。
4、重新加载扩展后，在 VSCode 中启动调试会话。
5、若仍无法中断，尝试在 service worker 文件顶部添加 debugger; 语句强制触发调试器连接。
