1. 项目概述：为什么我们需要告别坐标点击？

在Android应用的自动化测试或脚本操作领域，很多朋友，尤其是刚入门的开发者，第一个想到的方法往往是基于屏幕坐标的点击。比如，通过adb shell input tap 500 800这样的命令，或者在一些自动化工具里直接录制屏幕坐标。这种方法上手快，看似简单直接，但用过的都知道，它有多“脆弱”。

想象一下，你写了一个脚本，在分辨率为1080x1920的手机上，精准地点中了屏幕正中央的“登录”按钮。一切运行完美。但当你换了一台屏幕尺寸不同的手机，或者应用UI在版本更新后按钮位置发生了哪怕几个像素的偏移，你的脚本就立刻“瞎”了——它只会傻傻地点击原来的坐标位置，结果可能是点到了空白处，甚至是点到了其他不该点的按钮上。这种脚本毫无健壮性可言，维护成本极高，每次UI变动都是一场灾难。

这就是“坐标点击”的致命伤：它与具体的屏幕像素绑定，而非与应用的内在逻辑结构绑定。而我们要介绍的Poco，正是为了解决这个问题而生。它不是一个简单的“点击工具”，而是一个基于UI控件搜索的自动化框架。它的核心思想是：我不关心按钮在屏幕的哪个像素点，我只关心它是一个id为btn_login的按钮，或者它的text属性是“登录”。只要这个控件在应用的UI树（UI Hierarchy）里，Poco就能像我们操作DOM一样，精准地定位并操作它。

简单来说，Poco让我们的自动化脚本从“看图说话”（基于图像识别）或“盲人摸象”（基于坐标）升级到了“按图索骥”（基于控件属性）。这对于需要跨设备、跨分辨率运行，或者面对频繁UI迭代的项目来说，是质的飞跃。接下来，我将以一个完整的Android App为例，带你从零开始，彻底掌握用Poco精准操控UI的技巧。

2. 环境搭建与核心工具链

工欲善其事，必先利其器。要玩转Poco，我们需要一套顺手的工具。这里我推荐使用AirtestIDE作为集成开发环境，它完美整合了Airtest（图像识别）和Poco（UI控件识别）两大框架，并且提供了强大的实时UI树查看和脚本录制功能，极大降低了入门门槛。

2.1 核心工具安装与配置

首先，访问Airtest项目的官方网站，下载对应你操作系统的AirtestIDE。它是一个绿色软件，解压即可运行，无需复杂的安装过程。

启动AirtestIDE后，你会看到左侧是设备连接窗口，中间是脚本编辑器，右侧是Poco辅助窗和日志输出区。我们的第一步是连接一台Android设备。

连接真机：

1. 确保你的Android手机已开启“开发者选项”和“USB调试”模式。不同手机开启方式略有不同，通常在“设置”-“关于手机”中连续点击“版本号”7次即可激活开发者选项。
2. 用USB数据线连接手机和电脑。在电脑上首次连接时，手机会弹出“是否允许USB调试”的提示，务必点击“允许”。
3. 在AirtestIDE的设备窗口，点击刷新按钮，你应该能看到你的设备序列号。点击“连接”，状态变为绿色即表示连接成功。

注意：部分国内厂商的手机（如小米、华为、OPPO、VIVO）可能有额外的权限限制。如果连接后无法正常操作，可能需要进入“开发者选项”，开启“USB调试（安全设置）”或“允许通过USB安装应用”等选项。对于更严格的系统，可能需要在输入法设置中，将默认输入法切换为“Yosemite输入法”（这是Airtest注入的辅助输入法），具体可参考官方文档中关于“部分厂商设备特殊问题”的说明。

连接模拟器： 如果你使用Android模拟器（如夜神、雷电、官方AVD），连接方式更简单。确保模拟器已启动，在AirtestIDE的设备下拉菜单中选择对应的模拟器即可。通常，AirtestIDE能自动识别出运行中的模拟器。

连接成功后，AirtestIDE会自动向设备安装两个必要的服务APK：Airtest和PocoService。这是后续进行图像识别和UI控件识别的基石。

2.2 认识Poco辅助窗与UI树

设备连接成功后，将AirtestIDE右侧的标签页切换到“Poco”。点击下拉菜单，选择“Android”。此时，Poco辅助窗会开始获取当前设备屏幕的UI层级结构，并以树状图的形式展示出来，这就是我们常说的UI树或控件树。

这个UI树是Poco的灵魂。它完整映射了当前Activity中所有控件的层级关系和属性。例如，一个典型的按钮在UI树中可能呈现为：

<android.widget.Button> text="登录" name="btn_login" pos=[0.5, 0.8] ...

你可以通过点击UI树上的任意节点，在左侧设备预览图中，对应的UI控件会被高亮显示。反之，在设备预览图上双击某个控件，UI树也会自动定位并展开到对应的节点。这个双向定位功能是编写和调试Poco脚本的利器。

2.3 编写第一个Poco脚本

环境就绪，让我们立刻动手写一个最简单的Poco脚本，感受一下它的魅力。在AirtestIDE的脚本编辑区，新建一个.py文件。

# 导入poco库 from poco.drivers.android.uiautomation import AndroidUiautomationPoco # 初始化Poco对象，指定使用Android Uiautomation驱动 poco = AndroidUiautomationPoco() # 现在，假设我们要点击一个文本为“登录”的按钮 # 方法1：通过文本属性定位 poco(text="登录").click() # 方法2：通过控件类型和文本组合定位，更精确 poco("android.widget.Button", text="登录").click() # 方法3：如果控件有唯一的resource-id（类似于web中的id），这是最稳定的定位方式 # poco("com.example.app:id/btn_login").click()

将脚本保存，点击AirtestIDE顶部的运行按钮。你会看到脚本自动在你的手机上找到了“登录”按钮并完成点击。整个过程没有用到任何一个坐标数字！

这就是Poco的基础使用逻辑：先通过一系列属性选择器定位到目标控件，然后调用.click(),.set_text(),.swipe()等方法对其进行操作。它像极了前端开发中的jQuery选择器，或者Selenium中的find_element，非常符合程序员的直觉。

3. Poco核心定位策略详解

掌握了基础操作，我们来深入探讨Poco的“定位”艺术。精准定位是Poco脚本稳定性的根本。Poco提供了多种定位方式，我将它们分为三个层次：基础属性定位、层级关系定位和高级选择器定位。

3.1 基础属性定位：控件的“身份证”

这是最常用、最直观的定位方式。每个UI控件都有一系列属性，我们可以像查字典一样，用这些属性来找到它。

• text: 控件的显示文本。例如poco(text="搜索")。
• name: 控件的resource-id，在Android中通常是最稳定的唯一标识。例如poco(name="com.netease.cloudmusic:id/search_box")。强烈建议在开发阶段就为关键控件赋予有意义的resource-id，这是自动化脚本的最佳实践。
• type: 控件的类型，对应于Android中的类名。例如poco(type="android.widget.EditText")定位所有输入框。
• desc/content-desc: 控件的描述信息，常用于无障碍功能。对于没有文本的图标按钮，这可能是唯一的标识。

你可以单独使用一个属性，也可以组合使用，让定位更精确：

# 组合定位：类型是Button且文本为“确定” poco(type="android.widget.Button", text="确定").click() # 定位所有文本包含“设置”的控件（模糊匹配） poco(textMatches=".*设置.*")

实操心得：text属性虽然方便，但也是最容易因产品文案修改而失效的。name(resource-id)由开发人员设置，通常与业务逻辑绑定，变更频率远低于UI文案，是首选的定位依据。在编写脚本前，最好能与开发同学沟通，确认核心控件的id命名规则。

3.2 层级关系定位：控件的“家谱”

当多个控件属性相似时，我们就需要借助它们在UI树中的位置关系来精确定位。这就像在一个大家族里，光说找“小明”可能有好几个，但如果说“住在东厢房第二间的小明”，就唯一确定了。

• 子节点定位 (child)： 从父控件出发，查找其直接子控件。

  # 假设有一个id为`parent_layout`的布局，里面有一个登录按钮 parent = poco(name="com.example.app:id/parent_layout") login_btn = parent.child(name="com.example.app:id/btn_login") login_btn.click()

• 后代节点定位 (offspring)： 查找父控件下的所有后代控件（包括子、孙等）。

  # 找到父布局下所有类型为TextView的控件 all_text_views = parent.offspring(type="android.widget.TextView")

• 父子与兄弟节点定位： 通过parent()、sibling()等方法进行相对定位。

  # 先定位到一个已知控件，然后找它的父控件，再找父控件的另一个子控件 known_item = poco(text="项目A") container = known_item.parent() target_item = container.child(text="项目B")

• 索引定位： 当同一层级有多个相同属性的控件时，可以用索引来指定第几个。

  # 点击第三个文本为“选项”的按钮 poco(text="选项")[2].click() # 索引从0开始

3.3 高级选择器与等待策略

在实际项目中，UI控件不会总是乖乖地立即可用。网络加载、动画过渡都会导致控件出现有延迟。因此，等待是编写健壮Poco脚本的必修课。

• 显式等待 (wait)： 等待某个控件出现，并设置超时时间。

  # 等待最多10秒，直到“加载完成”的文本出现 success_text = poco(text="加载完成").wait(10) if success_text: print("页面加载成功") else: print("加载超时")

• 隐式等待 (wait_for_appearance/wait_for_disappearance)： 更语义化的等待，等待控件出现或消失。

  # 等待进度圈消失，最多等15秒 poco(name="loading_indicator").wait_for_disappearance(15)

• exists判断： 快速判断控件是否存在，不等待。

  if poco(text="升级提示").exists(): poco(text="稍后再说").click()

• 正则表达式与模糊匹配： 处理动态文本或部分匹配。

  # 匹配所有以“用户”开头的文本 poco(textMatches="^用户.*") # 匹配文本中包含“错误”的控件 poco(textMatches=".*错误.*")

将这些定位策略组合使用，你几乎可以应对任何复杂的UI定位场景。关键在于理解UI树的结构，并选择最稳定、最不易变化的属性作为定位锚点。

4. 完整实战：编写一个自动化测试脚本

理论说得再多，不如一个实战来得透彻。假设我们要为一个简单的“待办事项”App编写一个自动化测试脚本，完成“添加任务 -> 标记完成 -> 删除任务”的全流程。

4.1 步骤一：脚本框架与初始化

首先，我们规划脚本的主要步骤，并做好初始化和收尾工作。

# todo_auto_test.py import time from poco.drivers.android.uiautomation import AndroidUiautomationPoco from airtest.core.api import * # 初始化Poco poco = AndroidUiautomationPoco() # 假设我们的App包名是 com.example.todo APP_PACKAGE = "com.example.todo" def setup(): """测试前置操作：启动App""" print("启动待办事项App...") stop_app(APP_PACKAGE) # 确保从干净状态开始 start_app(APP_PACKAGE) time.sleep(2) # 等待App启动完成 # 等待主页面加载完成，通常可以通过一个标志性控件来判断 poco(text="我的待办").wait(5) print("App启动成功，进入主页面。") def teardown(): """测试后置操作：清理""" print("测试结束，清理环境...") stop_app(APP_PACKAGE) keyevent("HOME") # 回到桌面 def test_add_and_complete_task(): """核心测试用例：添加并完成一个任务""" print("\n--- 开始测试：添加并完成任务 ---") # 1. 点击“添加”按钮 print("步骤1: 点击添加按钮") poco(name="com.example.todo:id/fab_add").click() # 2. 在输入框中填写任务内容 print("步骤2: 输入任务内容") # 定位输入框，并清空可能存在的旧文本 input_field = poco(name="com.example.todo:id/et_task_input") input_field.set_text("") # 清空 input_field.set_text("学习Poco自动化框架") # 输入新文本 # 3. 点击“保存”按钮 print("步骤3: 点击保存") poco(name="com.example.todo:id/btn_save").click() # 4. 验证任务是否添加成功（等待新任务项出现） print("步骤4: 验证任务添加成功") # 新添加的任务项，可能是一个包含我们任务文本的视图 # 这里我们通过任务列表的某个子项文本来判断 # 假设任务列表是一个RecyclerView，其子项包含一个TextView显示任务内容 new_task = poco(text="学习Poco自动化框架").wait(5) assert new_task, "任务添加失败，未在列表中找到新任务！" print(" 验证通过：新任务已添加到列表。") # 5. 标记任务为完成（点击任务项旁的复选框） print("步骤5: 标记任务为完成") # 先找到任务项，再找它里面的复选框。这里用层级定位。 task_item = new_task.parent() # 假设文本的父布局是整个任务项 checkbox = task_item.child(name="com.example.todo:id/cb_task_complete") checkbox.click() # 6. 验证任务状态（例如，文本出现删除线或颜色变化） print("步骤6: 验证任务完成状态") # 这里可以通过判断任务文本的某个属性（如`enabled`为False）或寻找一个“已完成”图标来验证 # 假设完成的任务，其文本控件会多一个`checked`属性为True # 注意：这取决于App的具体实现，可能需要你实际查看UI树属性 # 这里我们用一个简单的等待，看是否有“完成”提示出现（如果App有的话） # poco(text="任务已完成").wait(3) # 示例，按实际情况调整 print(" 任务标记完成。") # 7. 删除任务（长按任务项，弹出菜单选择删除） print("步骤7: 长按任务项并删除") task_item.long_click() # 长按操作 # 等待删除菜单项出现并点击 poco(text="删除").wait(2).click() # 确认删除弹窗 poco(text="确认删除").wait(2).click() # 8. 验证任务已删除 print("步骤8: 验证任务已删除") time.sleep(1) # 给列表刷新一点时间 # 断言该任务的文本不再存在 assert not poco(text="学习Poco自动化框架").exists(), "任务删除失败！" print(" 验证通过：任务已从列表中删除。") print("--- 测试用例执行完毕 ---") if __name__ == "__main__": try: setup() test_add_and_complete_task() print("\n所有测试通过！") except Exception as e: print(f"\n测试执行过程中出现异常：{e}") # 这里可以加入截图功能，便于排查问题 snapshot(filename=f"error_{int(time.time())}.png") raise e finally: teardown()

4.2 步骤二：调试与增强脚本

上面的脚本是一个理想化的流程。实际运行中，你可能会遇到各种问题，这就需要我们利用AirtestIDE的强大功能进行调试。

1. 使用Poco辅助窗录制： 在编写click或set_text等操作时，不必手敲代码。在AirtestIDE中，点击Poco辅助窗上的“录制”按钮，然后在设备窗上操作你的App，IDE会自动生成对应的Poco语句并插入到脚本中。这是快速生成脚本骨架的绝佳方式。

2. 暂停与检查： 在脚本中插入time.sleep()是一种调试方法，但更优雅的是使用AirtestIDE的“暂停”功能。你可以在脚本编辑器中设置断点，或者直接点击运行控制栏的“暂停”按钮。暂停后，你可以自由地使用Poco辅助窗查看当前的UI树，检查控件属性是否与预期一致。

3. 属性动态探查： 有时，控件的一些关键属性（如checked,selected,bounds）在UI树中不会默认显示。你可以在脚本中使用attr()方法动态获取，或者直接在Poco辅助窗中，将鼠标悬停在控件节点上，查看其所有可用属性。

4. 加入断言与日志： 良好的测试脚本必须有明确的验证点（断言）。除了使用Python的assert，Poco也提供了一些内置的断言方法，如assert_exists()。同时，在关键步骤使用print输出日志，能让你在脚本运行时清晰地了解执行到了哪一步。

4.3 步骤三：处理复杂交互与异常场景

真实的App交互远比示例复杂。我们需要让脚本更智能。

• 滑动列表： 如果任务不在当前屏幕内，需要滑动列表。

  # 找到列表控件，然后向上滑动 task_list = poco(name="com.example.todo:id/rv_task_list") task_list.swipe([0.5, 0.8], [0.5, 0.2]) # 从底部80%位置滑到顶部20%位置

  swipe的参数是归一化的坐标（范围0~1），这使得滑动操作与分辨率无关。

• 处理弹窗与权限： App经常会有各种弹窗。

  # 在关键操作前，检查并处理可能出现的弹窗 def handle_popups(): if poco(text="允许").exists(): poco(text="允许").click() time.sleep(1) if poco(text="我知道了").exists(): poco(text="我知道了").click() time.sleep(1) # 在setup或每个操作步骤前调用

• 重试机制： 网络不稳定时，操作可能失败。

  from poco.exceptions import PocoNoSuchNodeException import time def click_with_retry(ui_element, retries=3, interval=1): for i in range(retries): try: ui_element.click() return True except PocoNoSuchNodeException: print(f"第{i+1}次点击失败，{interval}秒后重试...") time.sleep(interval) print("点击失败，达到最大重试次数。") return False # 使用 click_with_retry(poco(text="提交"))

通过这个完整的实战案例，你应该已经能够将Poco的各项功能串联起来，解决一个实际的自动化问题了。脚本的健壮性就体现在对这些细节和异常的处理上。

5. 进阶技巧与性能优化

当你熟练使用基础功能后，下面这些进阶技巧能让你如虎添翼，写出更高效、更强大的脚本。

5.1 使用focus和scroll进行精准定位

对于可滚动的列表（如ListView,RecyclerView），Poco提供了focus方法，可以将指定的子控件滚动到视图中。

# 假设我们有一个很长的通讯录列表，要找到“张三” # 直接定位可能因为控件不在屏幕内而失败 # poco(text="张三").click() # 可能失败 # 使用focus方法，Poco会尝试滚动列表直到目标控件出现 contact_list = poco(name="com.example.contact:id/list_view") contact_list.focus("text", "张三") # 现在再点击，成功率大大提升 poco(text="张三").click()

5.2 利用offspring进行批量操作

offspring可以获取某个节点下的所有后代，结合列表操作非常强大。

# 获取当前页面所有按钮的文本 all_buttons = poco(type="android.widget.Button").offspring() for btn in all_buttons: print(f"按钮文本: {btn.attr('text')}") # 勾选一个列表中的所有复选框 checkboxes = poco(name="com.example.app:id/item_layout").offspring(type="android.widget.CheckBox") for cb in checkboxes: if not cb.attr('checked'): cb.click()

5.3 脚本结构与模块化

当脚本越来越复杂时，良好的代码结构至关重要。

• 使用Page Object模式： 将每个页面的元素定位和操作封装成一个类。这样，当UI发生变化时，你只需要修改对应的页面类，而不需要到处修改脚本。

  class LoginPage: def __init__(self, poco): self.poco = poco self.username_input = poco(name="com.app:id/et_username") self.password_input = poco(name="com.app:id/et_password") self.login_button = poco(name="com.app:id/btn_login") def login(self, username, password): self.username_input.set_text(username) self.password_input.set_text(password) self.login_button.click() # 在脚本中使用 login_page = LoginPage(poco) login_page.login("testuser", "password123")

• 配置化： 将设备信息、App包名、账号密码等抽离到配置文件（如config.yaml或config.ini）中，使脚本更容易在不同环境下运行。

5.4 性能优化与稳定性提升

• 减少不必要的UI树dump： 每次调用poco(selector)，Poco默认都会从设备获取当前的UI树（dump hierarchy），这是一个相对耗时的操作。对于需要频繁操作同一批控件的场景，可以先将它们缓存起来。

  # 不好的做法：每次循环都重新查找 for i in range(10): poco(name="item")[i].click() # 每次click都会dump一次UI树 # 好的做法：先一次性获取所有元素 items = poco(name="item") # 只dump一次 for item in items: item.click() # 直接操作已获取的元素对象

• 设置合适的等待超时： 全局设置一个默认的等待超时时间，避免在找不到元素时无限等待。

  from poco.proxy import UIObjectProxy UIObjectProxy.DEFAULT_TIMEOUT = 10 # 设置默认超时为10秒

• 关闭不必要的截图和日志： 在AirtestIDE运行或生成报告时，默认会截图。在稳定的脚本中，可以关闭非关键步骤的截图以提升速度。

6. 常见问题排查与避坑指南

即使掌握了所有技巧，在实际编写和运行Poco脚本时，你依然会遇到各种各样的问题。下面是我总结的一些高频问题及其解决方案。

6.1 问题：Poco辅助窗无法显示UI树，或者显示为空/不全

这是新手遇到最多的问题。

• 原因1：未正确选择Poco模式或未接入SDK。

  • 排查： 检查AirtestIDE中Poco模式下拉菜单是否选择了正确的平台。对于原生Android App，应选择“Android”。对于游戏（如Unity、Cocos），必须确保游戏工程中已接入对应的Poco-SDK，并选择对应的模式（如Unity3D）。
  • 解决： 对于游戏，请严格按照官方文档接入SDK。对于原生Android App，如果选择Android模式后仍无UI树，尝试重启AirtestIDE和手机，并重新连接。

• 原因2：手机权限问题。

  • 排查： 连接手机时，AirtestIDE会尝试安装PocoService这个APK。如果安装失败，UI树就无法获取。
  • 解决：
    1. 确保手机已开启“USB安装”权限（在开发者选项里）。
    2. 部分手机（如华为）需要关闭“监控ADB安装应用”功能。
    3. 如果安装时手机有弹窗，务必点击“允许”。
    4. 可以尝试手动安装：在AirtestIDE安装目录的plugins\poco\poco\drivers\android\lib\pocoservice下找到pocoservice-debug.apk，用adb install命令手动安装到手机。

• 原因3：当前界面非原生Android控件。

  • 排查： 如果App使用了大量自定义View、Flutter、React Native或WebView（H5页面），标准的Android Poco驱动可能无法识别其内部控件。
  • 解决：
    • Flutter/React Native： 需要接入对应的Poco-SDK（Flutter版本或ReactNative版本）。
    • WebView： 需要切换到Poco的“WebView”或“Chrome”模式，并可能需要开启WebView的调试模式。
    • 极度自定义的View： 可能需要通过图像识别（Airtest）作为辅助，或者联系开发同学为自定义控件添加可访问性属性。

6.2 问题：脚本运行时找不到元素（PocoNoSuchNodeException）

• 原因1：控件尚未加载出来。

  • 解决： 在操作控件前，务必使用wait或wait_for_appearance进行等待。永远不要假设控件立即可用。

    # 错误示范 poco(text="加载后的按钮").click() # 可能因未加载而报错 # 正确示范 target_btn = poco(text="加载后的按钮").wait(10) # 等待最多10秒 if target_btn: target_btn.click() else: print("控件未在指定时间内出现")

• 原因2：定位语句写得不准确或控件属性已变化。

  • 解决： 使用AirtestIDE的暂停功能，在抛出异常的时刻暂停脚本，然后用Poco辅助窗仔细查看当前的UI树。确认你使用的text、name等属性值是否与当前UI树中的完全一致。注意文本中的空格、换行符等不可见字符。

• 原因3：控件在可滚动容器内，且当前不在可视区域。

  • 解决： 使用focus()方法先将控件滚动到视图中，再进行操作。

6.3 问题：脚本在部分设备上运行不稳定

• 原因1：设备性能差异导致UI响应速度不同。

  • 解决： 统一在关键操作后增加适当的、固定的等待时间（time.sleep(0.5)），或者使用基于控件状态的等待（如等待某个元素出现/消失），而不是基于时间的死等。将全局默认超时时间（DEFAULT_TIMEOUT）设置得宽松一些。

• 原因2：不同厂商系统的UI细节差异。

  • 解决： 避免使用绝对坐标或依赖于特定像素位置的断言。坚持使用控件属性进行定位和断言。如果某些系统控件（如权限弹窗）的文本不同，可以使用textMatches进行模糊匹配，或者准备多套定位语句备用。

6.4 问题：click()操作没有效果

• 原因1：点击位置被遮挡。

  • 排查： 可能有弹窗、悬浮按钮、键盘等覆盖在目标控件上方。
  • 解决： 点击前先判断并关闭可能的遮挡物。例如，先判断键盘是否弹出，如果弹出则点击返回键关闭。

    if poco(type="android.widget.EditText").exists(): keyevent("BACK") # 关闭键盘

• 原因2：控件实际不可点击。

  • 排查： 查看UI树中该控件的enabled、clickable属性是否为true。
  • 解决： 如果控件本身是disabled状态，那么click()是无效的。你需要先操作其他步骤使其变为可用状态。

• 原因3：需要的是长按、双击等特殊操作。

  • 解决： 使用Poco提供的其他操作方法，如long_click()、double_click()、drag_to()等。

6.5 一个实用的调试技巧：快照与属性打印

当脚本出现难以定位的问题时，将出错时的现场“冻结”下来是最好的方法。

try: poco(text="神秘按钮").click() except Exception as e: # 1. 截图保存当前屏幕 snapshot(filename=f"error_{int(time.time())}.png") print("已保存错误截图。") # 2. 打印当前页面所有同类控件的关键属性，帮助分析 all_buttons = poco(type="android.widget.Button") for i, btn in enumerate(all_buttons): print(f"按钮[{i}]: text={btn.attr('text')}, name={btn.attr('name')}, enabled={btn.attr('enabled')}") # 3. 重新抛出异常 raise e

掌握以上排查方法，你就能独立解决Poco脚本开发中90%以上的常见问题。记住，耐心查看UI树、合理添加等待、编写容错代码，是构建稳定自动化脚本的三条黄金法则。