PyAutoGUI 不可靠，尤其在 macOS 和 Wayland 下基本失效；Windows 上也易因焦点、缩放、多屏或 UI 变化而失败，因其依赖绝对坐标且不识别控件。
PyAutoGUI 不能可靠用于现代 GUI 自动化，尤其在 macOS 和 Wayland 环境下基本失效；即使在 Windows 上，也极易因窗口焦点、缩放比例、多显示器或 UI 动态变化而中断。
为什么 pyautogui.click() 经常点错位置或根本没反应
PyAutoGUI 基于绝对屏幕坐标工作，它不识别控件，只“盲打”。一旦窗口被拖动、缩放（如 Windows 缩放设为 125%）、DPI 变化，pyautogui.moveTo(500, 300) 就可能落在标题栏外甚至另一个窗口上。macOS 默认禁用辅助权限，pyautogui.typewrite() 会直接静默失败，且无报错提示。
- 必须提前调用
pyautogui.FAILSAFE = True（移动鼠标到左上角可强制中断） - Windows 用户需右键 Python 进程 → “以管理员身份运行”，否则无法向某些 UAC 提升窗口发送输入
- macOS 需手动开启：系统设置 → 隐私与安全性 → 辅助功能 → 勾选 Python 或终端进程
- 所有坐标操作前加
pyautogui.sleep(0.5)，避免因渲染延迟导致点击落空
如何用 pyautogui.locateOnScreen() 找图但不被抗锯齿/主题色搞崩
该函数依赖截图比对，UI 稍有变化（按钮文字换行、图标阴影、深色模式切换）就会返回 None。默认使用 OpenCV 的 cv2.matchTemplate，对亮度和对比度敏感。
- 截图务必用相同 DPI、相同缩放比、相同主题色环境导出，推荐用 Snipaste 截纯色背景下的按钮区域
- 传入
confidence=0.8参数（默认 0.99 太苛刻），但不要低于 0.7，否则误匹配率飙升 - 避免匹配含文字区域——字体渲染差异极大；优先截取图标、开关滑块、复选框这类图形稳定元素
- 用
pyautogui.locateCenterOnScreen()直接获取中心点，比先定位再算中心更安全
替代方案：什么时候该放弃 PyAutoGUI 改用其他方式
当目标程序是 Electron（VS Code、Slack）、JavaFX、WPF 或网页应用时，PyAutoGUI 是最后一招，不是首选。
立即学习“Python免费学习笔记（深入）”；
- Web 场景一律用
selenium+chromedriver，通过 CSS/XPath 定位，稳定且可跨平台 - Windows 桌面应用（如 Excel、Notepad++）优先试
pywinauto，它能枚举窗口句柄和控件 ID，不依赖图像 - macOS 原生应用可用
pyobjc调用 Accessibility API，比 PyAutoGUI 精确几个数量级 - 若只是模拟快捷键（如
Ctrl+S），用keyboard库比pyautogui.hotkey()更底层、更少被拦截
真正难的不是写几行 pyautogui.press()，而是判断当前界面是否已加载完成、按钮是否已启用、弹窗是否意外弹出——这些状态 PyAutoGUI 一概不知。你得自己加截图轮询、颜色采样、超时重试，最后代码量和维护成本远超直接用原生自动化框架。
