用途：编写、运行与维护可靠的端到端测试，适用于测试生成、CI 集成、trace 调试和跨浏览器验证。
核心原则：测试须确定性，不使用随机数据、时间断言或共享状态；优先使用面向用户的语义定位器（getByRole、getByText、getByLabel）而非 CSS 选择器；每个测试一个断言；trace 用于调试而非主要检测手段；默认并行，测试需隔离。
常用命令（保持原样）： npx playwright --version npx playwright codegen http://localhost:3000 npx playwright test --ui npx playwright test --trace on npx playwright show-trace test-results/trace.zip
配置检查：playwright.config.ts 设 fullyParallel: true；CI 重试 retries: 2（本地 0）；projects 覆盖所需浏览器（至少 Chromium，Safari 加 WebKit）；trace 配置 trace: 'on-first-retry'；必要时用 globalSetup 准备测试数据；testResultsDir 加入 .gitignore。
CI 要点：检出代码、安装 Node 22、npm ci、npx playwright install --with-deps、执行 npx playwright test，失败时上传 playwright-report 产物。
常见反模式：脆弱的 CSS 点击改用语义定位器；避免 waitForTimeout，改用 waitForResponse 等显式等待；不共享测试账号；CI 中启用重试应对网络波动；截图设为 only-on-failure；URL 用 baseURL 配置而非硬编码；可通过 expect(page).toHaveScreenshot() 增加视觉回归。
限制：具体最新版本需自行核实，官方文档、API 参考与版本发布信息见资料所引外部资源。