一、适用平台：PC（windows和mac均可用）

二、下载安装：

推荐使用命令行下载（因为会自动安装依赖库）：

pip install PyAutoGUI
1

该框架的依赖库还是蛮多的，第一次用的同学耐心等待所有依赖库下载完成

包下载：

https://pypi.org/project/PyAutoGUI/#files
1

如果直接在连接下载包的话，需要手动安装对应所需的依赖库，这个过程很烦，因为该库的依赖库还是蛮多的

三、必备调试工具/脚本

import pyautogui
import time
try:
    while True:
        x, y = pyautogui.position()    #获得鼠标所在位置
        print(x,y)     #打印当前鼠标所处位置
        time.sleep(1)
except KeyboardInterrupt:
    print('\nExit.')
123456789

脚本会每秒钟打印一次鼠标当前所在的位置信息。为了后续做自动化的时候使用。

特别注意：

Python移动鼠标、点击键盘非常快，调试过程中非常容易造成脚本失控的情况。该框架提供了一种特殊的停止脚本运行的方式：

当pyautogui.FAILSAFE = True时，如果把鼠标光标在屏幕左上角，PyAutoGUI函数就会产生pyautogui.FailSafeException异常。如果失控了，需要中断PyAutoGUI函数，就把鼠标光标在屏幕左上角。要禁用这个特性，就把FAILSAFE设置成False：

import pyautogui
# 紧急停止开关开启，鼠标快速移动到左上角即可停止
pyautogui.FAILSAFE = True
# 通过把pyautogui.PAUSE设置成float或int时间（秒），可以为所有的PyAutoGUI函数增加延迟
pyautogui.PAUSE = 2.5  
12345

四、常用函数介绍

1、鼠标相关函数

import pyautogui

width, height = pyautogui.size()  # 获得屏幕的分辨率
x, y = pyautogui.position()  # 获得鼠标所在坐标

pyautogui.moveTo(300, 300, duration=0.25)  # 移动鼠标（绝对坐标）
pyautogui.moveRel(100, 0, duration=0.25)   # 移动鼠标（相对位置），以当前鼠标位置为基准

# 模拟鼠标点击操作。
# clicks 点击次数，后面的 interval是间隔 ；
# x,y 默认为当前坐标，可以不填；
# button 默认点击左键，可选参数：‘left’, ‘middle’,  ‘right’
pyautogui.click(clicks=2, interval=0.25， x=0, y=0, button='left')   
# 点击等于封装了按下和弹起，如此可以模拟鼠标
# click = pyautogui.mouseDown + pyautogui.mouseUp  

# 鼠标按下
pyautogui.mouseDown(x=moveToX, y=moveToY, button='left')  
# 鼠标弹起
pyautogui.mouseUp(x=moveToX, y=moveToY, button='left')  

pyautogui.doubleClick()  # 鼠标双击，其实就是执行两次click()函数
pyautogui.rightClick()   # 右击
pyautogui.middleClick()  # 中击

pyautogui.dragTo()   # 拖拽，绝对坐标 参数等同于 moveTo
pyautogui.dragRel()  # 拖拽，相对坐标 参数等同于 moveRel

pyautogui.scroll(200)  # 滚轮，正值向上滚，负值向下滚
1234567891011121314151617181920212223242526272829

二、键盘操作：

import pyautogui

# 输入字符串，可选参数0.25为延时，可设置其他值
pyautogui.typewrite('Hello world!', 0.25)  
# 输出：XYab
pyautogui.typewrite(['enter', 'a', 'b', 'left', 'left', 'X', 'Y'], '0.25') 

pyautogui.KEYBOARD_KEYS # 按键名称列表

pyautogui.keyDown('f4') # 按下某个键, f4为例
pyautogui.keyUp('f4') # 松开某个键, f4为例
pyautogui.press('f4') # 一次完整的击键，前面两个函数的组合 , f4为例
pyautogui.hotkey('altleft', 'f4') #热键
12345678910111213

这里需要注意，键盘输入不支持直接输入中文。

解决方案：安装pyperclip用复制粘贴的方式解决

不同按键映射：

三、图片相关操作

import pyautogui

# 全屏截图
pyautogui.screenshot('foo.png') 
# 区域截图 左上角XY坐标值和宽度、高度传入截取
im = pyautogui.screenshot(region=(0, 0, 300 ,400)) 

# 获得某个坐标的像素，假设返回值是：(30, 132, 153)
im.getpixel((50, 200)) 
# 判断屏幕坐标的像素是不是等于某个值
pyautogui.pixelMatchesColor(50, 200, (30, 132, 153))  

# 找到 button 所在的位置。假设返回 (643, 745, 70, 29)，如果不存在返回None  
pyautogui.locateOnScreen('button.png', grayscale=False) 
# 获得中心点，没找到会返回None
x, y = pyautogui.center((643, 745, 70, 29))  
# 等价于上面的前两步操作，直接获得截屏幕中心坐标
pyautogui.locateCenterOnScreen('pyautogui/looks.png') 

# 检测 0，0 点在不在屏幕上，如果在返回true，否则返回false
pyautogui.onScreen(0, 0)
123456789101112131415161718192021

如果上述图片识别的方式对您不使用，可以参考之前专门介绍图片识别的OpenCV库的方法：

浅谈游戏自动化策略(图片比对)

四、弹窗

# 显示一个简单的带文字和OK按钮的消息弹窗。用户点击后返回button的文字
pyautogui.alert(text='', title='', button='OK') 

# 显示一个简单的带文字、OK和Cancel按钮的消息弹窗，用户点击后返回被点击button的文字
pyautogui.confirm(text='', title='', buttons=['OK', 'Cancel']) 
# 支持自定义数字、文字的列表
pyautogui.confirm(text='', title='', buttons=range(10)) 

# 可以输入的消息弹窗，带OK和Cancel按钮。用户点击OK按钮返回输入的文字，点击Cancel按钮返回None
pyautogui.prompt(text='', title='' , default='') 

# 样式同prompt()，用于输入密码，消息用*表示
pyautogui.password(text='', title='', default='', mask='*')
12345678910111213