PyAutoGUI点击失败主因是窗口未激活或坐标错误；需用getWindowsWithTitle().activate()聚焦，position()校验坐标，并处理高分屏缩放。
PyAutoGUI点击不到按钮？先确认窗口焦点和坐标偏移
PyAutoGUI操作失败，80% 是因为目标窗口没激活或坐标算错了。它不识别控件，只靠屏幕像素点，所以 pyautogui.click(x, y) 前必须确保目标窗口在最前、未被遮挡，且坐标是相对于**主屏幕左上角**（不是窗口内部）。
- 用
pyautogui.getWindowsWithTitle("窗口名")获取窗口对象，再调用.activate()强制聚焦（Windows/macOS 都支持，Linux 需额外工具） - 别手测坐标：运行
pyautogui.position()移动鼠标实时看坐标，或用pyautogui.screenshot().save("debug.png")截图后标点 - 高分屏（如 macOS Retina、Windows 缩放 125%/150%）会导致坐标翻倍，需用
pyautogui.size()校验实际分辨率，必要时除以缩放系数
pytest里怎么让GUI测试不卡住或失败就挂起？加超时和异常兜底
GUI 测试最怕卡在某个弹窗或加载动画上，pytest 默认不会中断 GUI 操作线程。必须手动加超时控制，且不能依赖 time.sleep() —— 它不解决等待逻辑，只掩盖问题。
- 用
pytest-timeout插件：安装后加命令行参数--timeout=30，超时直接杀进程 - 所有关键操作包一层重试+超时：比如等待按钮出现，别写
time.sleep(2)，改用pyautogui.locateOnScreen("button.png", confidence=0.9, minSearchTime=10)，minSearchTime是最大等待秒数 - 捕获
pyautogui.ImageNotFoundException和pygetwindow.PyGetWindowException，打印当前屏幕截图路径，方便复现
为什么截图匹配总失败？图像识别的三个硬限制
pyautogui.locateOnScreen() 看似简单，实际受 DPI、主题色、字体抗锯齿、动态内容（如时间戳、进度条）影响极大，不是“截个图就能认”。
- 截图必须从**目标环境**（同系统、同缩放、同暗色模式）截取，不能用设计稿或别人机器的图
- 避免匹配含文字区域：文字渲染差异大，优先截取图标、边框、固定形状的 UI 元素；用
confidence=0.8~0.95缓冲模糊，但别低于 0.7 - 如果界面有动画或闪烁元素（如 loading 圆圈），匹配前先等它静止：用
pyautogui.pixelMatchesColor(x, y, (r,g,b), tolerance=10)检查关键像素是否稳定
pytest + PyAutoGUI 的最小可行测试结构长什么样？
别一上来就写完整流程，先跑通一个按钮点击+响应验证。重点是隔离、可重入、不残留状态。
立即学习“Python免费学习笔记（深入）”；
- 每个测试函数开头调用
app_window = pygetwindow.getWindowsWithTitle("MyApp")[0]，结尾用app_window.close()（或发Ctrl+Q）清理 - 测试数据用临时目录：
temp_dir = tempfile.mkdtemp()，避免读写固定路径导致冲突 - 断言不用截图比对，改用副作用验证：比如点击“保存”后检查
os.path.exists(os.path.join(temp_dir, "output.txt")) - CI 环境无图形界面？PyAutoGUI 在 headless 下会报错，必须加
if os.environ.get("DISPLAY") or sys.platform == "win32":跳过或 mock
真实 GUI 测试最难的从来不是点哪里，而是判断“现在该点了吗”——时机比位置更难捉摸。截图匹配只是手段，背后得有一套对应用状态机的理解。
