pyautogui跨平台需按系统补依赖、设权限、适配坐标与图像识别差异：macOS需开启辅助功能权限，Linux需安装scrot和Pillow并设confidence，Windows需注意缩放导致的坐标偏移，多屏与高DPI下应动态获取尺寸并避免硬编码。
pyautogui 能跨平台做图形操作，但不是“装完就能跑”，必须按系统补依赖、设安全机制、处理坐标与图像识别差异。否则在 macOS 上卡权限、Linux 上截图失败、Windows 上点偏位置，都是常见结果。
macOS 上 pyautogui.click() 无响应？先开辅助功能权限
macOS 默认禁止外部程序控制鼠标键盘，pyautogui 的所有点击/移动都会静默失败，不报错也不执行。
- 手动开启：系统设置 → 隐私与安全性 → 辅助功能 → 勾选你的 Python 解释器（如
/usr/bin/python3或~/miniconda3/bin/python）或终端应用（如 Terminal / iTerm） - 验证是否生效：运行
pyautogui.position()能正常返回坐标，pyautogui.click()才可能触发 - 若用 PyCharm/VS Code 运行脚本，需单独勾选对应 IDE 的可执行文件路径，而非仅终端
Linux 下 locateOnScreen() 总是返回 None？检查 scrot 和 Pillow
pyautogui.locateOnScreen() 在 Linux 上依赖 scrot 截图 + Pillow 图像处理。缺任一环节，图像识别就直接失效。
- 确认已安装：
scrot（截图）、python3-tk（GUI 支持）、Pillow（图像解码）——仅pip install pyautogui不够 - 快速自检：
pyautogui.screenshot("test.png")能生成文件，且打开后内容正常，说明截图通；再试pyautogui.locateOnScreen("target.png", confidence=0.8) -
confidence参数必须显式设（默认 0.999 太高），实际场景中 0.7~0.8 更可靠；目标图建议用 PNG 格式，避免 JPEG 压缩失真
跨平台坐标写死会出问题？用 size() 和 onScreen() 动态适配
硬编码 pyautogui.click(1200, 600) 在不同分辨率或缩放比例下必然点错位置，尤其 macOS 启用“缩放显示”后，逻辑像素 ≠ 物理像素。
- 始终用
pyautogui.size()获取当前屏幕宽高，再按比例计算目标坐标（如中央点：w//2, h//2） - 关键操作前加校验：
if pyautogui.onScreen(x, y): pyautogui.click(x, y)，避免坐标越界导致异常 - 多显示器场景下，
pyautogui.size()返回的是主屏尺寸；若需操作副屏，得用pyautogui.getAllScreens()（需 Pillow ≥ 10.0）并手动定位
图像识别在高 DPI 或动态 UI 下总失败？别只靠 locateOnScreen
locateOnScreen() 是像素级匹配，在字体抗锯齿、窗口动画、系统缩放变化时鲁棒性差，不是万能定位方案。
立即学习“Python免费学习笔记（深入）”；
- 优先用绝对坐标 + 相对偏移：比如先定位一个稳定图标（如窗口左上角关闭按钮），再
moveRel(50, -20)点击其右侧菜单项 - 避免识别全屏动态区域（如视频播放器进度条、实时刷新的表格），改用文本 OCR（配合
pytesseract）或颜色采样（pixelMatchesColor()）辅助判断 - 性能敏感场景慎用循环重试：
while not locateOnScreen(...): sleep(0.5)易卡死；应设最大重试次数 + 超时抛异常
