PyAutoGUI使用region参数调用locateCenterOnScreen时报TypeError如何解决

错误根因 #

TypeError: cannot unpack non-iterable NoneType object 报错的本质是 locateCenterOnScreen 未在指定区域内匹配到目标图像，返回了None，若代码直接对返回值做坐标解包（例如 x,y = pyautogui.locateCenterOnScreen(...) 写法）就会触发该类型错误。 #

排查&解决方案 #

• 校验region参数格式是否正确：PyAutoGUI的region参数传入规则为(左边界x坐标, 上边界y坐标, 区域宽度, 区域高度)，而非很多用户默认以为的(左x, 上y, 右x, 下y)。你传入的(100,675,1400,600)对应的实际搜索范围是左x=100、上y=675、右x=100+1400=1500、下y=675+600=1275，如果你之前是按照右下坐标填写的第三、四位值，就会导致搜索区域和预期完全不符。
• 排查系统显示缩放导致的坐标偏移：如果你的Windows/Mac系统开了非100%的显示缩放，手动测量的逻辑坐标和PyAutoGUI实际读取的物理像素坐标不匹配，会导致指定的region区域和预期位置错位。可先关闭显示缩放后重试，或者将手动测量的坐标乘以缩放比例换算为物理像素坐标再填入region参数。
• 验证搜索区域是否符合预期：可先运行调试代码截取指定region的截图，直接确认区域范围是否正确、是否包含目标按钮：

  pyautogui.screenshot(region=(100,675,1400,600)).save('debug_region.png')
  

  打开保存的debug_region.png即可直观判断搜索区域是否存在偏差。
• 增加代码容错处理：即使定位逻辑正常，也建议先判断返回值是否为None再做解包操作，避免偶现匹配失败时程序直接崩溃：

  target_pos = pyautogui.locateCenterOnScreen('~/file-01.png', region=(100,675,1400,600), confidence=0.6)
  if target_pos:
      x, y = target_pos
      # 执行后续点击等操作
  else:
      # 自定义匹配失败的处理逻辑
      print("未定位到目标元素")
  

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