asyncio.run()不能直接运行UI自动化脚本，因pyautogui等库是同步阻塞的；应使用asyncio.to_thread()或run_in_executor()封装操作，避免await同步调用、sleep模拟等待及混写逻辑。
asyncio.run() 不能直接跑 UI 自动化脚本
因为绝大多数 UI 自动化库（如 pyautogui、uiautomation、甚至 selenium 的某些驱动）本身不是协程友好的——它们的 API 是同步阻塞的，调用 click() 或 type_text() 会卡住当前线程，await 它们毫无意义。
强行用 asyncio.run() 包一层，只是把整个同步流程扔进新事件循环里跑，没解决阻塞问题，反而可能触发 RuntimeError: asyncio.run() cannot be called from a running event loop。
- 真正要非阻塞，得把耗时操作丢到线程池执行，再用
asyncio.to_thread()（Python 3.9+）或loop.run_in_executor()封装成 awaitable - UI 操作本身无法“并发”——两个
pyautogui.click()调用不能同时发生，但你可以让等待响应、截图分析、文件读写等 IO 或 CPU 密集型步骤并行化 - 别碰
asyncio.sleep()替代 UI 等待：它不感知界面状态，容易因页面加载慢导致点击失败；该用显式等待就用pyautogui.locateOnScreen()+ 循环重试
pyautogui 在 asyncio 中怎么安全调用
pyautogui 所有操作（moveTo()、click()、press()）都是同步且全局阻塞的，直接 await 会报 TypeError: object NoneType can't be used in 'await' expression。
正确做法是把它“异步化包装”：
立即学习“Python免费学习笔记（深入）”；
import asyncio import pyautogui <p>async def safe_click(x, y): await asyncio.to_thread(pyautogui.click, x, y)</p><h1>或 Python 3.8 及更早：</h1><p>async def safe_click_legacy(x, y): loop = asyncio.get_running_loop() await loop.run_in_executor(None, pyautogui.click, x, y)
- 必须用
asyncio.to_thread()（推荐）或run_in_executor()，不能用asyncio.sleep()模拟延迟——那是假并发，UI 状态没变 -
pyautogui.FAILSAFE = True建议保留，避免脚本失控时无法中断 - 频繁调用
pyautogui.locateOnScreen()会很慢，建议先screenshot()一次，再用locateAllOnScreen()在内存图像中搜，然后用to_thread()包裹
测试逻辑怎么组织才不卡死又可复用
一个典型误区：把整套 UI 流程写成单个 async def test_login_flow()，里面混着 await 和同步调用，结果某次 pyautogui.typewrite() 卡住 5 秒，整个协程挂起，后续断言全失效。
应该按“可等待单元”拆解：
- 每个 UI 动作封装为独立
async函数（如async def enter_username(text)），内部只做一件事 + 显式超时控制 - 等待界面变化统一走
await wait_for_element_appear('login_button.png', timeout=10)，这个函数自己用to_thread()调locateOnScreen()并轮询 - 避免在协程里做长循环：
while not found: await asyncio.sleep(0.2)比time.sleep(0.2)弱很多，但仍不如用asyncio.wait_for()包一层轮询任务 - 截图、日志、异常截图这些辅助操作也该进线程池，否则一出错就拖慢整个测试流程
为什么 selenium + asyncio 组合更容易翻车
看起来 selenium 有 WebDriver 实例，能用 asyncio 控制多个浏览器？其实不行。它的 .find_element()、.click() 全是同步 HTTP 请求，底层用的是 urllib3，不是 aiohttp。
常见错误现象：RuntimeError: Cannot run the event loop while another loop is running，尤其在 pytest + asyncio 插件环境下。
- 不要尝试
await driver.find_element(...)—— 它根本不是协程，也不返回Awaitable - 如果真要多浏览器并发，得用多个
ProcessPoolExecutor或启动多个 pytest 进程，而不是靠 asyncio 并发驱动 -
selenium-wire或playwright的异步版（playwright.async_api）才是真异步，但它们和pyautogui不兼容——前者控浏览器，后者控桌面，混用需格外注意焦点和坐标系偏移
最常被忽略的一点：所有基于图像识别的 UI 自动化（pyautogui / uiautomation）都依赖屏幕分辨率、缩放比例、窗口位置。同一段 async 代码，在 125% 缩放的 Windows 和 100% 的 macOS 上，locateOnScreen() 极可能找不到目标——这跟 asyncio 无关，但会让你花半天 debug 却发现是 DPI 问题。
