Playwright 元素定位优先级（稳定优先，UI 自动化最佳实践）
核心原则：业务语义 > 唯一标识 > 角色可访问性 > 属性 > 文本 > 样式 xpath/css，规避会随 UI 改版、样式、DOM 结构变动而失效的定位。
推荐优先级从高到低（生产实测）
-
get_by_role()【最高优先】page.get_by_role("button", name="提交")
- 优点：基于可访问性语义，不依赖 DOM id/class，对前端重构容忍度高，符合无障碍规范；
- 适合：按钮、输入框、下拉、表格、链接；
- 缺点：同一个 role 元素多的时候，需要搭配 name/filter 过滤。
-
测试专用属性
data-testid（强烈推荐，后端 / 前端约定加上）page.get_by_test_id("submit‑btn")
- 这是 Playwright 官方最推荐的稳定定位；
- 专门给自动化用，业务代码不会随便修改这个属性，不受文案、样式、id 变化影响。
-
id（前提：id 不是动态生成！）
page.locator("#username")
- ⚠️ 避坑：很多前端框架 React/Vue 会生成动态 id 如
el‑1234，每次刷新 id 变化，这种 id 绝对不能用； - 只有写死的静态 id 才放这个优先级。
-
get_by_label()标签关联输入框page.get_by_label("手机号码")
- 表单场景神器，label 绑定 input，就算 input 改 id、改 class，只要 label 文字不变就可用。
-
get_by_placeholder()占位符page.get_by_placeholder("请输入密码")
适合输入框；缺点：placeholder 文案会被产品改，会失效。
get_by_text()/get_by_title()
- 依据页面可见文本；
- 风险：多语言、文案改版直接失效，尽量少做主定位，多用于过滤筛选。
- CSS / XPath（尽量降级，不优先）
- 不写绝对路径 xpath：
//div[2]/div[1]/span，DOM 一改直接挂； - 可以写相对、基于属性的 css/xpath，作为兜底。
❌ 尽量避免的定位方式
- 动态生成 id；
- css 按 class 样式类（
class="css‑ab123"，前端打包经常变）； - 绝对层级 xpath；
- 依赖元素下标硬编码（
.nth(3)，新增元素直接错位）。
一句话总结优先级速查表
get_by_testid > get_by_role > 静态id > get_by_label > get_by_placeholder > get_by_text > css/xpath兜底补充：你提到的 get_by_role 的小坑
get_by_role 有时候会匹配到多个隐藏元素，此时搭配 .filter() 缩小范围：
page.get_by_role("button").filter(has_text="保存")业务实操建议：如果可以推动前端埋
data‑testid，直接用这个，稳定性碾压绝大多数定位；如果不能埋，就优先get_by_role。
●修复完成。问题根因和修复说明：
问题根因
❌ 之前的写法 --- filter(has_text=...) 要求文本在元素内部
page.get_by_role("checkbox").filter(has_text="私隱")
Ant Design 的 checkbox 结构中，文本通常在相邻的 里，不在 元素内部，所以 has_text 永远匹配不到。
修复后的定位链（3 级降级）
✅ 第 1 优先：get_by_label ---Playwright 通过 label 文本找关联的 checkbox
page.get_by_label("私隱政策聲明")
✅ 第 2 降级：找到包含文本的 ，再找里面的 checkbox
page.locator('label:has-text("私隱政策聲明")').locator('inputtype="checkbox"')
✅ 第 3 降级：索引定位（warranty 占 2 个，privacy 是第 3 个 = index 2）
page.get_by_role("checkbox").nth(2)
核心原理：get_by_label() 查找的是可访问性名称（accessible name），即 label 关联的表单元素，不要求文本在元素内部，所以能正确处理 label 与 input 分离的 Ant Design
结构。
修复文件状态
99: get_by_role("button", name="提交", exact=True)
103: get_by_role("button", name="配置", exact=True)
107: get_by_role("button", name="下載", exact=True)
111: get_by_role("button", name="更改", exact=True)
137: get_by_label("私隱聲明") ←替代 filter(has_text)
所有按钮已统一精确匹配，复选框已改为基于可访问性 label 的定位方式。