应优先使用data-testid、id、aria-label或文本内容等稳定属性替代动态class名定位，如page.locator('button:has-text("提交")')；若class有规律，可用[class^="prefix"]或[class*="btn-"]匹配；避免硬写XPath或依赖动态class，因其易随渲染变化而失效。
用属性选择器绕过动态class名
Playwright不依赖class名定位元素，直接用data-* 属性、id、aria-label或文本内容更可靠。动态class（如btn_abc123、card_x9z8q）每次渲染都变，硬写page.locator(".btn_x9z8q")必然失败。
常见做法是让前端配合加稳定属性，比如：data-testid="submit-btn" 或 data-role="search-input"。若无法改前端，则转向其他稳定锚点：
- 用
page.locator('button:has-text("提交")')—— 文本内容通常不变 - 用
page.locator('input[placeholder="请输入邮箱"]')—— placeholder 属性很少动态生成 - 用
page.locator('div >> nth=2')—— 仅当结构绝对稳定且无插入/删除时才临时用 - 用
page.locator('article').filter(has_text="最新公告")—— 先取父容器再过滤子内容
用正则匹配class前缀或模式
如果class命名有规律（例如固定前缀+随机后缀），可用CSS属性选择器配合^=（开头匹配）或*=（包含匹配）：
page.locator('div[class^="card_"]') # 匹配 class="card_ab12"、"card_xyz789"
page.locator('button[class*="btn-"]') # 匹配 class="primary-btn-active"、"btn-submit-9a"
注意：不能用/regex/语法直接写在CSS里；Playwright的locator不支持正则class匹配，但可通过get_by_role或filter间接实现：
立即学习“Python免费学习笔记（深入）”；
-
page.get_by_role("button").filter(has_text="保存")比 class 更稳 -
page.locator("div").filter(has_attribute="class", has_attribute_value=re.compile(r"^item_\w{5}$"))—— 需导入re，且性能略低，慎用于高频操作
避免用XPath硬写class名导致维护崩溃
有人会写page.locator('//button[contains(@class, "submit_")][1]')，看似能用，但XPath在Playwright中默认不推荐：它比CSS慢、可读性差、且容易因DOM微调断裂（比如多了一个空格或顺序换位）。
真正该做的是反向确认：这个元素是否真的没有其他稳定标识？如果没有，优先推动加data-test-id；如果纯临时脚本，用nth()加显式等待更安全：
-
page.locator("nav > ul > li").nth(3).click()—— 前提是导航栏结构长期不变 - 务必搭配
wait_for_timeout(100)或expect(locator).to_be_visible()，防止因异步加载未完成而点击空白 - 别用
//div[@class="dynamic-xyz"]/button——class值一旦变化，整条XPath失效
为什么page.wait_for_selector()不能解决class动态问题？
wait_for_selector(".loading_7k8m")只是等某个class出现，但下一次运行class就变成.loading_pq2r，等待永远超时。它不帮你“猜”新class，也不做模式匹配。
真正有效的等待方式是等语义状态，不是等class：
page.wait_for_selector("text=加载完成", state="attached")-
page.wait_for_selector("button:not([disabled])", state="visible")—— 等按钮启用而非等某个class消失 -
page.locator("input").wait_for(state="editable")—— 比等class*="enabled"更准确
动态class本质是前端框架（React/Vue）的产物，它的存在就是为了隔离样式与逻辑。你越试图捕获它，脚本越脆弱。盯住用户能看到、测试者能描述、产品能承诺不变的东西——文本、角色、状态、位置关系——才是Playwright定位的正确起点。
