第一步：

pip install pyautogui

安装pyautogui库。

第二步：

基本使用

screenWidth, screenHeight=pyautogui.size()# 屏幕尺寸mouseX, mouseY=pyautogui.position()# 返回当前鼠标位置，注意坐标系统中左上方是(0, 0)

为了保持用户可以随时干预鼠标键盘的动作，比较好的方法是添加停顿，或者强制结束，否则想停了鼠标还一直在晃就会失控，下面是两种对应的设置

pyautogui.PAUSE=1.5# 每个函数执行后停顿1.5秒

pyautogui.FAILSAFE=True# 鼠标移到左上角会触发FailSafeException，因此快速移动鼠标到左上角也可以停止

鼠标操作

移动

w, h=pyautogui.size()

pyautogui.moveTo(w/2, h/2)# 基本移动

pyautogui.moveTo(100,200, duration=2)# 移动过程持续2s完成

pyautogui.moveTo(None,500)# X方向不变，Y方向移动到500

pyautogui.moveRel(-40,500)# 相对位置移动

拖动

# 点击+向下拖动

pyautogui.click(941,34, button='left')pyautogui.dragRel(0,100, button='left', duration=5)

点击

pyautogui.click(300,400, button='right')# 包含了move的点击，右键

pyautogui.click(clicks=2, interval=0.25)# 双击，间隔0.25s

滚轮

pyautogui.scroll(-10)

键盘操作

输入文字

点击对话框输入文字即可，不过中文好像不行

pyautogui.click(1279,374)pyautogui.typewrite('hello world!')

精确控制键盘

以下是手动输入中文的方法

pyautogui.press('shift')# 切换输入法的中英文

pyautogui.press(['#',' '])# press 可以对单个字符或者列表进行操作

pyautogui.press(['x','i','a','o'])

pyautogui.press(['y','u'])

pyautogui.press(['w','e','i'])

pyautogui.press(['l','a','n'])

pyautogui.press(' ')

hotKey

pyautogui.hotkey('shift','a')# 可以使用组合键，本质上是

'''pyautogui.keyDown('shift')

pyautogui.keyDown('a')

pyautogui.keyUp('shift')

pyautogui.keyUp('a')'''

消息弹窗函数

如果你需要消息弹窗，通过单击OK暂停程序，或者向用户显示一些信息，消息弹窗函数就会有类似JavaScript的功能：

In [ ]:

pyautogui.alert('这个消息弹窗是文字+OK按钮')

pyautogui.confirm('这个消息弹窗是文字+OK+Cancel按钮')

pyautogui.prompt('这个消息弹窗是让用户输入字符串，单击OK')

Out[ ]:

print(pyautogui.alert('这个消息弹窗是文字+OK按钮'))

print(pyautogui.confirm('这个消息弹窗是文字+OK+Cancel按钮'))

str1 = pyautogui.confirm(text='1-10', title='test', buttons=range(10))

print(str1)

str1 =pyautogui.prompt('这个消息弹窗是让用户输入字符串，单击OK')

print(str1)

str1 = pyautogui.password(text='密码', title='填', default='123', mask='*')

print(str1)

在prompt()函数中，如果用户什么都不输入，就会返回None。

截屏函数

PyAutoGUI用Pillow/PIL库实现图片相关的识别和操作。

在Linux里面，你必须执行sudo apt-get install scrot来使用截屏特性。

In [ ]:

#  返回一个Pillow/PIL的Image对象pyautogui.screenshot()pyautogui.screenshot('foo.png')

如果你有一个图片文件想在上面做点击操作，你可以用locateOnScreen()函数来定位。

In [ ]:

#  返回(最左x坐标，最顶y坐标，宽度，高度)

pyautogui.locateOnScreen('pyautogui/looks.png')

Out[ ]:

(0, 1040, 48, 40)

locateAllOnScreen()函数会寻找所有相似图片，返回一个生成器：

In [ ]:

for i in pyautogui.locateAllOnScreen('pyautogui/looks.png'):

    print(i)

(0, 1040, 48, 40)

In [ ]:

list(pyautogui.locateAllOnScreen('pyautogui/looks.png'))

Out[ ]:

[(0, 1040, 48, 40)]

locateCenterOnScreen()函数会返回图片在屏幕上的中心XY轴坐标值：

In [ ]:

pyautogui.locateCenterOnScreen('pyautogui/looks.png')

Out[ ]:

(24, 1060)

如果没找到图片会返回None。

定位比较慢，一般得用1~2秒

缓动/渐变（Tween / Easing）函数

缓动/渐变函数的作用是让光标的移动更炫。如果你不需要用到的话，你可以忽略这些。

缓动/渐变函数可以改变光标移动过程的速度和方向。通常鼠标是匀速直线运动，这就是线性缓动/渐变函数。PyAutoGUI有30种缓动/渐变函数，可以通过pyautogui.ease*?查看。其中，pyautogui.easeInQuad()函数可以用于moveTo()，moveRel()，dragTo()和dragRel()函数，光标移动呈现先慢后快的效果，整个过程的时间还是和原来一样。而pyautogui.easeOutQuad函数的效果相反：光标开始移动很快，然后慢慢减速。pyautogui.easeOutElastic是弹簧效果，首先越过终点，然后再反弹回来。例如：

In [ ]:

#  开始很慢，不断加速

pyautogui.moveTo(100,100,2,pyautogui.easeInQuad)

#  开始很快，不断减速

pyautogui.moveTo(100,100,2,pyautogui.easeOutQuad)

#  开始和结束都快，中间比较慢

pyautogui.moveTo(100,100,2,pyautogui.easeInOutQuad)

#  一步一徘徊前进

pyautogui.moveTo(100,100,2,pyautogui.easeInBounce)

#  徘徊幅度更大，甚至超过起点和终点

pyautogui.moveTo(100,100,2,pyautogui.easeInElastic)

这些效果函数是模仿Al Sweigart的PyTweening模块，可以直接使用，不需要额外安装。

如果你想创建自己的效果，也可以定义一个函数，其参数是(0.0,1.0)，表示起点和终点，返回值是介于[0.0,1.0]之间的数。

鼠标单击

click()函数模拟单击鼠标左键一次的行为。例如：

In [ ]:

pyautogui.click()

如果单机之前要先移动，可以把目标的XY坐标值传入函数：

In [ ]:

#  先移动到(100, 200)再单击pyautogui.click(x=100,y=200,duration=2)

可以通过button参数设置left，middle和right三个键。例如：

In [ ]:

pyautogui.click(button='right')

要做多次单击可以设置clicks参数，还有interval参数可以设置每次单击之间的时间间隔。例如：

In [ ]:

#  双击左键

pyautogui.click(clicks=2)

#  两次单击之间停留0.25秒

pyautogui.click(clicks=2,interval=0.25)

#  三击右键

pyautogui.click(button='right',clicks=2,interval=0.25)

为了操作方便，PyAutoGUI提供了doubleClick()，tripleClick()和rightClick()来实现双击、三击和右击操作。

鼠标按下和松开函数

mouseDown()和mouseUp()函数可以实现鼠标按下和鼠标松开的操作。两者参数相同，有x，y和button。例如：

In [ ]:

#  鼠标左键按下再松开

pyautogui.mouseDown();

pyautogui.mouseUp()

#  按下鼠标右键

pyautogui.mouseDown(button='right')

#  移动到(100, 200)位置，然后松开鼠标右键

pyautogui.mouseUp(button='right',x=100,y=200)

滚轮滚动函数

鼠标滚轮滚动可以用scroll()函数和clicks次数参数来模拟。不同平台上的clicks次数不太一样。还有x和y参数可以在滚动之前定位到(x, y)位置。例如：

In [ ]:

#  向上滚动10格

pyautogui.scroll(10)

#  向下滚动10格

pyautogui.scroll(-10)

#  移动到(100, 100)位置再向上滚动10格

pyautogui.scroll(10,x=100,y=100)

在OS X和Linux平台上，PyAutoGUI还可以用hscroll()实现水平滚动。例如：

In [ ]:

#  向右滚动10格

pyautogui.hscroll(10)

#  向左滚动10格

pyautogui.hscroll(-10)

scroll()函数是vscroll()的一个包装（wrapper），执行竖直滚动。