最可靠的方式是用 get_by_role("button", name="文本")，因其基于可访问性标签语义化匹配，不受DOM结构变化、换行空格影响，且避免误匹配子元素或非按钮元素。
用 get_by_role("button", name="文本") 是最可靠的方式
Playwright 的 get_by_role 是专为语义化定位设计的，当按钮有可访问性标签（如 aria-label、title 或可见文本）时，它能稳定匹配，且不受 DOM 结构微调影响。比用 locator("button:has-text('文本')") 更健壮，尤其在按钮含换行、空格或前后缀时不会意外失效。
常见错误是直接写 locator("button").filter(has_text="文本") —— 这会匹配到任意子元素含该文本的按钮（比如按钮里嵌了个 span），实际点击的可能是不可交互的内部节点。
- 确保按钮文本是“完全可见且未被截断”的，否则
name匹配可能失败（Playwright 默认只匹配渲染后可见文本） - 若文本含动态部分（如 “提交 (3)”），可用正则：
page.get_by_role("button", name=re.compile(r"提交\s*\(\d+\)")) - 不推荐用
text=参数（如get_by_text("文本").first），它会匹配所有元素，不限定角色，容易误点链接或 div
当按钮没语义化文本时，用 filter() + inner_text() 精确判断
有些按钮靠图标+tooltip 或纯 CSS 伪元素显示文本，name 匹配不到。这时得先取一组候选按钮，再逐个检查真实渲染文本。
示例：
buttons = page.locator("button")
count = buttons.count()
for i in range(count):
btn = buttons.nth(i)
if "删除" in btn.inner_text().strip():
btn.click()
break
注意：inner_text() 返回的是浏览器实际渲染的文本（含换行归一化、空格压缩），比 text_content() 更贴近用户所见；但性能略低，别在大循环里无限制调用。
- 务必加
.strip()，因为按钮文本前后常有空格或换行符 - 避免用
is_visible()单独判断——它不保证文本已渲染完成，应和inner_text()配合使用或加wait_for - 如果按钮文本异步加载（如从 API 填充），需先
btn.wait_for(state="visible")再取文本
警惕 :has-text() 的隐式行为和大小写陷阱
locator("button:has-text('确认')") 看似简单，但默认是“包含匹配”，不是“精确匹配”。它会命中 “确认订单”、“二次确认” 这类按钮，而且不区分大小写——除非显式加 i 标志，否则可能漏掉大小写敏感场景。
- 要精确匹配整段文本，必须写成
locator("button:text-is('确认')")（注意是text-is，不是text） - 若需忽略大小写做精确匹配：
locator("button:text-is('确认', ignoreCase=True)") -
:has-text()会触发 layout 触发，频繁使用可能拖慢测试执行；生产环境调试时建议优先用get_by_role
移动端或 Shadow DOM 中按钮匹配要额外处理
在 WebView 或自定义组件中，按钮可能藏在 Shadow Root 里，或者被 user-select: none 干扰文本提取。这时候 get_by_role 仍有效，但需先 shadow_root 定位。
示例：
host = page.locator("my-custom-button")
shadow = host.evaluate_handle("el => el.shadowRoot")
button = shadow.evaluate_handle("root => root.querySelector('button')")
# 或更简洁地：
button = host.locator("::shadow button").get_by_role("button", name="保存")
真机或模拟器上还要注意：iOS Safari 对 aria-label 支持较弱，有时得退回到 data-testid 属性定位——所以开发阶段最好推动团队统一加 data-testid，比依赖文本更可控。
文本匹配看着简单，但真正稳定的关键在于理解 Playwright 是按“用户视角”而非“DOM 树视角”工作的。一旦按钮文本在屏幕上看不见、被裁剪、或由 JS 异步注入，所有基于文本的定位都得配合显式等待和渲染验证，不能只靠 selector 一招鲜。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
