chrome扩展v3中background.js实为事件驱动的service worker，非持久进程，需在chrome.runtime等事件监听器内设断点，通过chrome://extensions点击“service worker”唤醒并调试，且须以--remote-debugging-port启动chrome才能vscode attach。
Background脚本在v3里其实是Service Worker
Chrome 扩展 v3 已彻底移除 background.page，改用 service_worker 字段声明后台逻辑。这意味着你写的 background.js 不是常驻进程，而是事件驱动、按需唤醒的 Service Worker。VSCode 断点打在文件顶层，基本无效——它根本不会执行。
必须在 manifest.json 中正确声明：
"background": {
"service_worker": "background.js",
"type": "module"
}
type: "module" 非必需但推荐，否则 import 会报错；路径必须是相对于 manifest.json 的，不能带 ./ 前缀（Chrome 不认）。
断点必须设在事件监听器内部
Service Worker 只有在触发对应生命周期或 API 事件时才会启动。常见有效断点位置包括：
chrome.runtime.onInstalled.addListener(() => { debugger; })chrome.runtime.onMessage.addListener((msg, sender, sendResponse) => { debugger; })chrome.tabs.onUpdated.addListener((tabId, changeInfo, tab) => { if (changeInfo.status === 'complete') debugger; })
别在 background.js 文件最外层写 console.log 或 debugger，它不会运行；也别指望修改完代码后刷新页面就能触发——SW 是独立上下文，和网页无关。
调试入口只能手动唤醒 + Attach
VSCode 的 launch.json 无法自动启动或唤醒 background service worker。你必须先让 Chrome 加载并激活它：
- 打开
chrome://extensions - 启用“开发者模式”，找到你的扩展，确认已加载成功
- 点击 “inspect views: service worker” —— 这一步强制唤醒 SW 并建立 DevTools 连接
此时 VSCode 才能通过 attach 模式连接。推荐的 launch.json 配置片段：
{
"type": "pwa-chrome",
"request": "attach",
"name": "Attach to SW",
"urlFilter": "chrome-extension://*/_generated_background_page.html",
"port": 9222,
"webRoot": "${workspaceFolder}"
}
注意：urlFilter 必须是这个固定路径，不是你本地文件名；port 要和 Chrome 启动参数一致（见下一条）。
Chrome 必须带远程调试端口启动
默认 Chrome 不开放调试协议，VSCode attach 失败多半是因为没开 --remote-debugging-port=9222。
两种方式任选其一：
- 手动启动：终端运行
chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug（Linux/macOS）或start chrome --remote-debugging-port=9222 --user-data-dir="C:\temp\chrome-debug"（Windows） - 用
web-ext run --target=chrome --start-url=http://example.com，它会自动加参数并开新实例（推荐，避免污染主 Chrome）
如果用了已有 Chrome 窗口又没加参数，VSCode 就连不上 _generated_background_page.html 上下文，断点永远空心圆。
最易被忽略的一点：每次改了 background.js，必须重新加载扩展（chrome.runtime.reload() 或禁用/启用），否则旧 SW 缓存仍在运行，VSCode 连上的还是旧代码。
