VSCode调试Puppeteer断点不生效，主因是调试配置未匹配其无头模式：需用pwa-chrome的attach模式（而非launch），设port为9222、webRoot指向源码，并确保Puppeteer启动时添加--remote-debugging-port=9222等参数。
VSCode 调试 Puppeteer 时断点不生效？检查 launch.json 的 type 和 request 类型
断点不命中，大概率是调试配置没对上 Puppeteer 的运行模式。Puppeteer 默认启动的是无头 Chromium 实例，而 VSCode 的 pwa-chrome 或 pwa-msedge 配置默认期望连接的是「已打开的、带 UI 的浏览器」，不是 Puppeteer 自启的后台进程。
正确做法是用 attach 模式，而非 launch 模式：
- 在 Puppeteer 启动代码中显式加
args: ['--remote-debugging-port=9222'] -
launch.json中type设为pwa-chrome，request设为attach，并指定port: 9222 - 确保
webRoot指向源码目录（如${workspaceFolder}），否则断点映射失败 - 不要同时运行多个 Puppeteer 实例监听同一端口，会报
ERR_ADDRESS_IN_USE
Puppeteer 启动后 DevTools 打不开？WebSocket 连接被拒绝的常见原因
VSCode 报错 Could not connect to browser via WebSocket，通常是端口暴露或权限问题。Puppeteer 的 --remote-debugging-port 只开放本地回环地址（127.0.0.1），但某些系统或 Docker 环境下可能绑定到 0.0.0.0 导致安全拦截。
实操建议：
- 启动 Puppeteer 时加完整参数：
headless: false+args: ['--remote-debugging-port=9222', '--remote-debugging-address=127.0.0.1'] - 验证端口是否真在监听：
lsof -i :9222（macOS/Linux）或netstat -ano | findstr :9222（Windows） - 如果用 WSL，注意 Windows 防火墙可能拦截端口，临时关闭或放行
9222 - 别依赖
chrome://version/页面里的 WebSocket 地址——它属于 Chrome 桌面版，和 Puppeteer 启的实例无关
为什么改用 puppeteer-core + connect() 更稳定？
用完整版 puppeteer 启动浏览器时，VSCode 调试器常因进程生命周期管理混乱而断连：比如脚本结束、异常退出、或 browser.close() 触发后整个 CDP 会话被销毁，断点就失效了。
换成 puppeteer-core 后，你完全掌控浏览器实例：
- 手动启动 Chrome 并带调试参数：
chrome --remote-debugging-port=9222 --no-first-run --no-default-browser-check - 代码里用
puppeteer.connect({ browserWSEndpoint: 'ws://localhost:9222/devtools/browser/...' }) - WebSocket URL 必须从
http://localhost:9222/json接口取真实值，不能手敲或复用旧链接（每次重启 Chrome，ID 都变） - 这样 VSCode attach 的是「长期存活」的浏览器进程，调试上下文不会随脚本结束而丢失
TypeScript 项目里变量显示为 undefined？sourceMap 没配对
TS 编译后的 JS 文件和原始 TS 行号对不上，VSCode 就没法把断点打到正确位置，变量面板也读不到原始变量名。
必须确认三件事：
-
tsconfig.json中"sourceMap": true且"outDir"和"rootDir"设置合理 -
launch.json的webRoot指向 TS 源码目录（不是dist或build） - 运行 Puppeteer 的入口文件要是 TS（如
index.ts），而不是直接跑编译后的 JS —— 否则 sourceMap 根本不加载 - VSCode 底部状态栏能看到
Source map detected提示才算生效
真正卡住人的，往往不是 Puppeteer 本身，而是调试链路上任意一环的 sourceMap 断点映射失败。哪怕只漏掉一个 sourceMap: true，你看到的就全是编译后变量名和乱序行号。
