根本原因是PyAutoGUI坐标系不统一：size()返回逻辑分辨率，screenshot()返回实际像素，locateOnScreen()结果属截图坐标系，而moveTo()按逻辑坐标系解释，高DPI下三者错位导致偏移。
根本原因不是代码写错了，而是 PyAutoGUI 的坐标系统直接映射操作系统屏幕像素，而不同分辨率下同一逻辑位置对应的像素值完全不同——尤其当高 DPI 缩放介入时，size()、截图、鼠标移动三者坐标系天然不一致。
PyAutoGUI.size() 返回的是逻辑分辨率，不是真实像素
在 Windows/macOS 高 DPI 显示器上，pyautogui.size() 常返回“缩放后”的逻辑尺寸。例如 4K 屏设为 200% 缩放时，它可能返回 (1920, 1080)；但 pyautogui.screenshot().size 实际是 (3840, 2160)。两者差值就是缩放因子（如 2.0）。
常见错误现象：
-
locateOnScreen()在高 DPI 截图中找到坐标(x, y)，直接传给moveTo(x, y)，结果鼠标点到目标左上角四分之一处 - 脚本在开发机（1920×1080）运行正常，部署到 2560×1440 或 MacBook Retina 屏就完全偏移
验证方法：运行以下两行，对比输出
立即学习“Python免费学习笔记（深入）”；
print(pyautogui.size()) print(pyautogui.screenshot().size)
若数值不等，说明存在缩放偏差，必须手动对齐。
图像定位返回的坐标属于截图坐标系，不能直传 moveTo()
locateOnScreen() 匹配的是你当前截图的实际像素位置，而 moveTo() 默认按 size() 所示的逻辑坐标系解释输入值。二者错位，必偏移。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
实操建议：
- 显式计算缩放因子：
scale = screenshot.size[0] / pyautogui.size()[0] - 定位后统一缩放：
pyautogui.moveTo(x / scale, y / scale) - macOS Retina 屏常见
scale = 2，可先硬编码验证：pyautogui.moveTo(x/2, y/2) - 避免用
locateCenterOnScreen()后直接解包传参，务必先除缩放因子
依赖绝对坐标的脚本在多屏/动态环境下必然失效
哪怕分辨率一致，多显示器排列顺序变化、主屏切换、窗口最大化都会改变元素绝对坐标。硬编码 (320, 180) 这类值，本质是把 UI 当成了静态位图，而非可交互对象。
更鲁棒的做法：
- 用
locateOnScreen('app_window_title.png')先找窗口，再基于其位置计算内部控件偏移 - 截取最小可行区域（如仅按钮文字+边框），降低误匹配率
- 避免依赖桌面背景、浏览器标签页或任务栏位置——它们极易被用户改动
- 对按钮/图标等目标，优先用图像识别 +
confidence=0.7–0.85，比纯坐标鲁棒得多
OpenCV 支持缺失导致匹配精度严重下降
PyAutoGUI 默认用 Pillow 做图像比对，抗缩放、抗色差能力极弱；启用 OpenCV 后，pyscreeze 会自动切换至 cv2.matchTemplate，大幅提升稳定性。
关键动作：
- 必须执行：
pip install opencv-python（不是opencv-contrib-python） - 验证是否生效：
import cv2; print(cv2.__version__) - 显式传
confidence参数（如0.4–0.6），尤其在 macOS HiDPI 下，原始 PNG 渲染后存在亚像素差异 - 不安装 OpenCV 时，
confidence再低也难匹配成功，容易误判为“图像不存在”
最易被忽略的点：PyAutoGUI 自身不处理 DPI 感知，所有坐标转换必须由你显式完成。没有“自动适配”这回事——size()、截图、鼠标移动三者坐标系必须手动对齐，缺一不可。
