vscode中“录制测试”无反应或脚本运行超时，根本原因是项目未真正就绪：需确保工作区为项目根目录、存在playwright.config.ts/js、已本地安装@playwright/test并执行npx playwright install下载浏览器。
VSCode 里点“录制测试”没反应，或者录完脚本一跑就 TimeoutError: locator.click: Timeout 10000ms exceeded——根本不是插件坏了，而是项目没真正就绪，或录制逻辑被默认配置绕过去了。
Playwright 插件不激活？检查项目根目录和配置文件是否存在
插件（ms-playwright.playwright）只在满足两个硬条件时才启用录制功能：当前 VSCode 工作区必须是项目根目录（含 package.json），且目录下存在 playwright.config.ts 或 playwright.config.js。
- 如果只是打开单个
.spec.ts文件，插件完全静默，右键无“Record”选项 - 运行
npx playwright test --version报错Cannot find module '@playwright/test'，说明@playwright/test没装在本地node_modules中 - 用
pnpm的项目需额外执行pnpm exec playwright install chromium，否则node_modules/.bin/playwright虽存在但无法调用浏览器 - Windows + WSL 用户：VSCode 在 WSL 中打开项目时，
codegen无法弹出 GUI 浏览器，必须切回 Windows 原生终端执行录制
npx playwright codegen 不起作用？端口、浏览器、权限三连查
codegen 默认启动 Chromium 并监听 0.0.0.0:8080，但这个端口常被公司代理、Docker 或本地服务占用，导致静默失败。
- 手动试一次：
npx playwright codegen https://example.com，观察终端是否输出browserType.launch: Executable doesn't exist—— 若有，先运行npx playwright install chromium - 若卡住无响应，加
--port 0让系统自动分配空闲端口：npx playwright codegen --port 0 --browser firefox https://example.com - macOS 上首次运行可能被 Gatekeeper 阻止，需去「系统设置 > 隐私与安全性」手动允许
Chromium和WebKit运行 - 若项目
playwright.config.ts中配置了webServer，codegen会等待服务就绪才启动，而你根本没起服务——删掉或注释掉该段再试
录制生成的脚本一跑就超时？定位器不稳定是常态，不是 bug
插件生成的 page.locator('div').nth(3).click() 或 page.getByText('Submit') 是基于 DOM 快照的“快照式推导”，React/Vue 动态 key、Shadow DOM、异步加载内容都会让它失效。
- 别依赖
nth()，改用语义化定位：page.getByRole('button', { name: 'Submit' })或page.getByLabel('Email address') -
getByText('Save', { exact: false })容易误匹配，应设{ exact: true }并确保文本完全一致 - 遇到动态 ID（如
id="btn-12345"），优先用data-testid属性，前端需配合加：<button data-testid="save-button"></button> - 录制后立刻运行测试，观察控制台是否报
waiting for element to be visible—— 若有，说明页面还没加载完就执行了操作，加await page.waitForLoadState('networkidle')或显式等待目标元素
调试时断点不生效？VSCode 默认连不上 Playwright 的 worker 进程
Playwright 默认并行运行测试（workers: 4），但 VSCode 的调试器只 attach 主进程，子 worker 里的 debugger 会被跳过。
- 临时禁用并行：在
playwright.config.ts中设workers: 1和retries: 0 - 调试前务必用 Ctrl+Shift+P（Mac Cmd+Shift+P）打开命令面板，选
Debug: Select and Start Debugging→Playwright Test（不是Node.js） - 确保测试文件名匹配默认模式（如
example.spec.ts），否则调试器找不到入口；可在配置中用testMatch: ['**/*.e2e.ts']显式指定 - 如果用了自定义
launch配置（比如加了headless: false），调试时浏览器窗口可能被快速关闭——在配置中加slowMo: 500可放慢操作节奏便于观察
真正卡住的地方往往不是“怎么点录制按钮”，而是 playwright.config.ts 里一行 webServer 配置让 codegen 死等、或是 node_modules/.bin/playwright 存在但没浏览器可调用——这些细节不会报红字错误，只会安静失败。
