pyautogui.moveTo() 偏移是因Windows高DPI缩放导致坐标失真，需设置DPI感知（注册表或兼容性选项）；click需先locate再计算中心点；typewrite不支持中文输入法，应改用粘贴或系统命令；默认PAUSE和FAILSAFE易致卡顿，需按需调整。
pyautogui.moveTo() 移不到预期位置？先关掉高 DPI 缩放
Windows 上用 pyautogui.moveTo() 发现鼠标总偏移几十像素，不是代码写错了，大概率是系统高 DPI 缩放惹的祸。Python 进程默认不声明 DPI 感知，Windows 会强制缩放坐标，pyautogui 读到的屏幕尺寸和实际像素不一致。
- 右键点击 Python 解释器（如
python.exe）→ 属性 → 兼容性 → 更改高 DPI 设置 → 勾选「替代高 DPI 缩放行为」→ 下拉选「应用程序」 - 或者在脚本开头加三行（需管理员权限运行一次注册表）：
import ctypes<br>ctypes.windll.shcore.SetProcessDpiAwareness(1)
- macOS/Linux 一般无此问题；但 macOS Catalina+ 需在「系统设置 → 隐私与安全性 → 自动化」里给 Python 进程授权「控制你的电脑」
pyautogui.click() 点不中按钮？别跳过定位 + 偏移校准
pyautogui.click() 本身不识别 UI 元素，它只按绝对坐标点。所谓“点按钮”，本质是你手动或用 pyautogui.locateOnScreen() 找图后，再算中心点——漏掉这步，就等于蒙眼点屏。
- 用
pyautogui.locateOnScreen('button.png')返回的是(left, top, width, height)，真实点击坐标得是(left + width//2, top + height//2) - 截图必须和目标窗口分辨率、缩放比例、主题色完全一致；推荐用灰度模式提速：
pyautogui.locateOnScreen('btn.png', grayscale=True) - 找不到图时别硬等，加超时和重试：
location = pyautogui.locateOnScreen('x.png', confidence=0.8, minSearchTime=3)（confidence降低可容忍模糊，但别低于 0.7）
键盘输入中文失败？pyautogui.typewrite() 不走系统输入法
pyautogui.typewrite() 是逐键发送按键事件，压根不经过输入法框架。直接传中文字符串，只会打出拼音字母或乱码，不是 bug，是设计如此。
- Windows 下稳妥方案：用
pyautogui.hotkey('ctrl', 'v')配合提前复制好内容到剪贴板（pyperclip.copy('你好')） - macOS 可用 AppleScript 中转：
os.system('''osascript -e 'tell application "System Events" to keystroke "你好"' ''') - Linux（X11）试试
xdotool：os.system('xdotool type --clearmodifiers "你好"')，但需提前sudo apt install xdotool
脚本跑着跑着卡住？pyautogui 默认有 0.1 秒操作间隔和防故障机制
pyautogui 内置了 FAILSAFE（鼠标移到左上角自动抛异常）和默认 PAUSE=0.1，这两者常被忽略，导致调试时“明明代码执行完了，却卡住不动”。
立即学习“Python免费学习笔记（深入）”；
- 临时禁用防故障：运行前加
pyautogui.FAILSAFE = False（仅调试用，正式环境务必留着） - 想加快速度？设
pyautogui.PAUSE = 0.01或干脆0，但某些老旧软件（比如 IE 内嵌控件）反而因太快收不到事件而失败 - 最隐蔽的卡点：调用
pyautogui.screenshot()在多显示器且主次屏缩放不同时，可能阻塞数秒——换用mss库截特定区域更稳
真正难的从来不是模拟动作，而是让动作落在对的时间、对的上下文里。窗口是否激活、焦点是否在目标控件、后台程序是否抢了输入权……这些状态没法靠 pyautogui 自己感知，得你用 psutil 或系统命令去查，再补一层判断逻辑。
