Playwright for VS Code插件必须安装后手动配置才真正可用：需在项目根目录运行npm init playwright@latest初始化，生成playwright.config.ts和tests目录，并确保@playwright/test已本地安装，否则录制按钮灰显、报错Cannot find module。
Playwright for VS Code 插件怎么装才真正可用？
装完插件不代表能自动同步测试——它不接管你的终端命令，也不监听文件变化，必须手动配置才能触发录制、运行、调试闭环。
- 从扩展市场搜
Playwright for VS Code（微软官方出品，作者ms-playwright），安装后重启 VS Code - 确保项目根目录已初始化 Playwright：运行
npx playwright install或npm init playwright@latest生成playwright.config.ts和tests/目录 - 插件依赖本地
playwright包，若全局安装（npm install -g playwright）或未在node_modules中找到，录制按钮会灰掉且报错Cannot find module 'playwright'
为什么点“Record”没反应，或者脚本生成后跑不通？
录制功能默认只写到 tests/example.spec.ts，但实际执行时可能因路径、baseURL 或浏览器上下文配置缺失而失败。
- 首次录制前，检查
playwright.config.ts是否设置了use: { baseURL: 'http://localhost:3000' }；没设的话，生成的await page.goto('...')会用相对路径，直接 404 - 录制生成的代码默认用
chromium，但如果你只装了firefox，得手动改test.use({ browserName: 'firefox' })或补装：npx playwright install firefox - 若页面含 iframe 或动态加载内容，录制器可能漏掉关键交互——它不等 DOM 就绪，建议后续加
await page.waitForSelector('.submit-btn')手动补强
Sync 测试行为和 VS Code 设置同步是两回事
别指望 Settings Sync 能把 tests/ 文件夹或 playwright.config.ts 自动推到另一台机器——这些属于项目代码，不是用户设置，不会被 Sync: Upload Settings 捕获。
- 想多设备复用同一套测试脚本，必须把
tests/、playwright.config.ts、package.json中的playwright依赖一起提交到 Git - Settings Sync 只同步你个人的 VS Code 行为偏好：比如是否启用
playwright.testOnSave这个配置项，但它不传测试文件本身 - 插件 UI 状态（如侧边栏是否展开 Test Explorer）会被同步，但断点位置、上次运行结果这些临时状态不会
Test Explorer 里点击 “Run” 却卡在 pending？
Playwright 插件调用的是本地 npx playwright test，不是后台服务——任何终端权限、PATH 或 Node 版本问题都会静默失败，只显示 “pending”。
- 打开 VS Code 内置终端（
Ctrl+`），手动运行npx playwright test，看真实报错：常见如Cannot find module 'ts-node'（缺 TypeScript 支持）或EACCES: permission denied（macOS 上 npm 全局权限混乱） - 检查
settings.json是否误禁用了自动运行："playwright.testOnSave": false或"playwright.autoExpandTestExplorer": false不影响执行，但会掩盖入口 - Windows 用户注意：PowerShell 默认执行策略可能阻止
npx脚本，临时用Set-ExecutionPolicy RemoteSigned -Scope CurrentUser解锁
