Mac系统下pyautogui定位Telegram联系人异常问题求助

核心原因 #

Mac的菜单栏/状态栏和Dock栏会占用屏幕坐标空间，PyAutoGUI默认使用包含系统元素的全局坐标，但Telegram窗口的实际内容区域坐标是排除这些区域的，导致定位偏移。另外，Retina屏幕的高分辨率缩放也可能让截图识别的坐标出现偏差。

具体解决方案 #

1. 适配Retina屏幕分辨率 #

Mac的Retina屏幕存在像素缩放，PyAutoGUI需要修正坐标比例：

import pyautogui
# 开启安全模式，移动到屏幕角落可终止程序
pyautogui.FAILSAFE = True
# 获取屏幕缩放比例
screen_scale = pyautogui.screenshot().size[0] / pyautogui.size()[0]

定位后对坐标进行修正：

to_click = pyautogui.locateCenterOnScreen(contact)
if to_click:
    corrected_x = to_click[0] / screen_scale
    corrected_y = to_click[1] / screen_scale
    pyautogui.click(corrected_x, corrected_y)

2. 锁定Telegram窗口区域查找 #

直接打开Telegram后，窗口可能未完全激活，导致识别范围包含系统栏。可以通过窗口对象限制查找区域：

import pygetwindow as gw

# 获取并激活Telegram窗口
telegram_windows = gw.getWindowsWithTitle("Telegram")
if telegram_windows:
    telegram_win = telegram_windows[0]
    telegram_win.activate()
    sleep(1)
    # 定义窗口的坐标范围
    win_region = (telegram_win.left, telegram_win.top, telegram_win.width, telegram_win.height)
    # 仅在窗口范围内查找截图
    to_click = pyautogui.locateCenterOnScreen(contact, region=win_region)

注：需先安装pygetwindow库，执行pip install pygetwindow即可。

3. 降低截图匹配精度阈值 #

如果截图存在细微差异，可通过confidence参数降低匹配要求（需安装opencv-python）：

# 先安装依赖：pip install opencv-python
to_click = pyautogui.locateCenterOnScreen(contact, confidence=0.8)

同时确保contact.png是Telegram窗口内的纯净区域截图，不要包含窗口边框或系统栏。

4. 临时关闭Dock自动隐藏 #

若Dock处于自动隐藏状态，会干扰坐标计算：
打开系统设置 > 桌面与程序坞 > 程序坞，取消勾选“自动显示和隐藏程序坞”后再测试。

完整修正代码 #

import os
import pyautogui
from time import sleep
import pygetwindow as gw

os.system('open /Applications/Telegram.app')
sleep(3)

# 获取并激活Telegram窗口
telegram_windows = gw.getWindowsWithTitle("Telegram")
if not telegram_windows:
    print("Telegram窗口未找到")
    exit()

telegram_win = telegram_windows[0]
telegram_win.activate()
sleep(1)

# 适配Retina屏幕缩放
screen_scale = pyautogui.screenshot().size[0] / pyautogui.size()[0]

# 定义窗口查找区域
win_region = (telegram_win.left, telegram_win.top, telegram_win.width, telegram_win.height)
contact_path = os.path.abspath('contact.png')

# 查找目标截图
to_click = pyautogui.locateCenterOnScreen(contact_path, region=win_region, confidence=0.8)
if to_click:
    corrected_x = to_click[0] / screen_scale
    corrected_y = to_click[1] / screen_scale
    pyautogui.click(corrected_x, corrected_y)
    print("已定位并点击目标联系人")
else:
    print("未找到目标联系人截图")

内容的提问来源于stack exchange，提问作者Gul Ganis