pyautogui.click() 偏移主因是系统缩放导致物理像素与逻辑坐标不匹配，需按缩放比例折算坐标；图像匹配脆弱，须同环境截图并调 confidence；中文输入需借剪贴板；FAILSAFE 和系统权限常致异常。
pyautogui.click() 点不到目标位置？先确认坐标系和缩放比例
macOS 或高分屏 Windows 上 pyautogui.click() 总是偏移，不是代码写错，而是系统 UI 缩放没对齐。pyautogui 读取的是物理像素坐标，但系统可能以 200% 缩放渲染界面，导致你用截图工具量出的“100, 200”在 pyautogui 里实际要传 (50, 100)（缩放 2x 时）。
- Windows：查「显示设置 → 缩放与布局」，若非 100%，需手动折算坐标，或改用
pyautogui.FAILSAFE = False后配合pyautogui.size()校验当前有效分辨率 - macOS：启用「显示器 → 默认缩放」中的「更多空间」模式会触发 Retina 像素翻倍，
pyautogui.position()返回的是逻辑坐标，但locateOnScreen()匹配的是物理图像 —— 必须用confidence=0.9+ 截图时关闭模糊/动画，否则找不到 - 调试技巧：运行前加
print(pyautogui.position())，把鼠标悬停在目标按钮上，看输出是否和你量的一致；不一致就说明缩放干扰了
locateOnScreen() 找不到按钮图片？图像匹配比你想的更脆弱
pyautogui.locateOnScreen() 不是 OCR，它只做灰度模板匹配，只要按钮背景色、字体抗锯齿、阴影、动效帧稍有不同，就直接失败。
- 截图必须来自同一台机器、同一分辨率、同一缩放、同一主题（比如深色模式下按钮颜色变，就得重截）
- 避免截到窗口边框或阴影 —— 用画图工具裁剪干净，保存为 PNG，不要 JPEG（有压缩噪点）
- 加
confidence=0.8可缓解轻微失真，但别低于 0.7，否则误匹配概率飙升；配合grayscale=True能提速且略稳，前提是目标和背景亮度区分明显 - 如果按钮文字会变（如「提交 (3)」），别截整个按钮，只截图标或固定文字部分，再用
region=(x, y, w, h)锁定搜索范围，大幅减少干扰
键盘输入中文乱码或卡住？pyautogui.typewrite() 不走系统输入法
pyautogui.typewrite() 发送的是键码（keycode），不是文本流。它能敲 a、enter、ctrl+v，但没法让微信或钉钉弹出中文输入法候选框 —— 输入法进程根本不接收它的事件。
- 纯英文/数字场景：放心用
pyautogui.typewrite("hello123")，加interval=0.1防太快被丢键 - 需要中文：必须先用
pyautogui.hotkey("ctrl", "v")配合系统剪贴板。先pyperclip.copy("你好")，再聚焦目标窗口，再pyautogui.hotkey("ctrl", "v") - 注意焦点：
pyautogui.typewrite()前务必确保目标窗口已激活，否则键发到后台去了。可用pyautogui.getWindowsWithTitle("微信")+.activate()（Windows/macOS 12+ 支持有限，建议用pygetwindow补足）
脚本一运行就鼠标乱跳？FAILSAFE 触发和权限问题最常被忽略
pyautogui 默认开启 FAILSAFE：鼠标移到左上角 (0, 0) 会立刻抛 FailSafeException 并中断脚本。这本是安全机制，但新手常因手抖、远程桌面缩放错乱、多显示器拖拽误触，导致脚本“莫名退出”。
立即学习“Python免费学习笔记（深入）”；
- 开发阶段可临时关掉：
pyautogui.FAILSAFE = False，但上线前务必打开，否则鼠标失控可能点穿重要对话框 - macOS 上首次运行会弹「辅助功能权限」，必须手动去「系统设置 → 隐私与安全性 → 辅助功能」里勾选你的 Python 进程（不是 Terminal.app，是 python 或 pycharm 的具体路径）
- Linux（X11）需确保
DISPLAY环境变量正确，Wayland 下基本不可用 —— 别在 Ubuntu 22.04+ 默认桌面试，换 Xorg 会话或改用xdotool
坐标的物理性、图像的脆弱性、输入法的隔离性、系统的权限墙——这四点没对齐，再熟的 API 也会表现得像抽风。调的时候别急着改逻辑，先盯死这四个地方。
