Python控制鼠标和键盘-PyAutoGUI

PyAutoGUI是用Python写的一个模块，使用它可以控制鼠标和键盘。

利用它可以实现自动化任务，再也不用担心有重复枯燥的任务了。

pyautogui模块的功能：

• 移动鼠标、点击左右键和滚轮
• 发送虚拟按键

# 安装pyautogui

这个模块支持Windows, Mac OS X 和 Linux。

根据系统不同，你可能需要安装一些依赖。

Linux系统（Debian系列）：

1 2 3 4 5

$ sudo apt - get install python3 - pip $ sudo pip3 install python3 - xlib $ sudo apt - get install scrot $ sudo apt - get install python3 - tk $ and sudo apt - get install python3 - dev

Scrot是pyautogui使用的截图工具。

Mac OS X：

1 2 3 4

$ sudo pip3 install pyobjc - framework - Quartz $ sudo pip3 install pyobjc - core $ sudo pip3 install pyobjc $ sudo pip3 install pillow

OS X上的Python3可以通过brewhome或port安装。

Windows系统不用安装依赖。

安装完依赖之后，安装pyautogui：

1 2 3

$ sudo pip3 install pyautogui # Windows pip install pyautogui

导入模块测试：

1	import pyautogui

# 准备

Python移动鼠标、点击键盘非常快，有可以导致其他应用出现问题。如果出现了问题，而鼠标还一直瞎晃，在这种情况下，你很难点击窗口退出程序。

两种解决方法：

#1 pyautogui的暂停和Fail-Safe

你可以告诉你的Python脚本在每执行一个函数后暂停几秒钟，这样你就有了几秒种的控制权。

1 2 3

import pyautogui   pyautogui . PAUSE = 1.5

fail-safe：当鼠标移动到屏幕的左上角时触法PyAutoGUI的FailSafeException异常。你可以使用try except语句处理异常，或直接让脚本异常退出。如果你想终止程序，只要你快速的把鼠标移动到屏幕左上角就可以了。

1 2 3

import pyautogui   pyautogui . FAILSAFE = True

#2 注销系统

这个方法比较粗暴直接，不建议使用。Windows和Linux的快捷键是：Ctrl–Alt–Del；Mac OS X的快捷键是Command–Shift–Option-Q。

# 移动鼠标

PyAutoGUI使用x，y坐标，屏幕左上角坐标是(0, 0)。

1366×768分辨率：

使用pyautogui.size()函数获得屏幕的分辨率：

1 2 3 4 5

import pyautogui   pyautogui . size ( ) # (1366, 768) width , height = pyautogui . size ( )

Ok，现在我们得到了屏幕的分辨率，下面我们来控制鼠标移动。

moveTo函数，绝对坐标。(block.py)：

1 2 3 4 5 6

import pyautogui for i in range ( 10 ) :        pyautogui .moveTo ( 300 , 300 , duration = 0.25 )        pyautogui .moveTo ( 400 , 300 , duration = 0.25 )        pyautogui .moveTo ( 400 , 400 , duration = 0.25 )        pyautogui .moveTo ( 300 , 400 , duration = 0.25 )

执行：

1	$ python3 block .py

上面代码让鼠标顺时针移动，并划10次方框。

划圆：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

import pyautogui import math   width , height = pyautogui . size ( )   r = 250    # 圆的半径 # 圆心 o_x = width / 2 o_y = height / 2   pi = 3.1415926   for i in range ( 10 ) :    # 转10圈 for angle in range ( 0 , 360 , 5 ) :    # 利用圆的参数方程 X = o_x + r * math . sin ( angle * pi / 180 ) Y = o_y + r * math . cos ( angle * pi / 180 )   pyautogui . moveTo ( X , Y , duration = 0.1 )

moveRel()函数，相对坐标。以当前鼠标所在位置为基点：

1 2 3 4 5 6 7

import pyautogui   for i in range ( 10 ) :      pyautogui .moveRel ( 100 , 0 , duration = 0.25 )      pyautogui .moveRel ( 0 , 100 , duration = 0.25 )      pyautogui .moveRel ( - 100 , 0 , duration = 0.25 )      pyautogui .moveRel ( 0 , - 100 , duration = 0.25 )

获得鼠标所在坐标：

1 2 3

import pyautogui   x , y = pyautogui . position ( )

实时获得鼠标位置坐标：

1 2 3 4 5 6 7

import pyautogui try :      while True :          x , y = pyautogui . position ( )          print ( x , y ) except KeyboardInterrupt :      print ( '\nExit.' )

# 鼠标点击、拖拽和滚轮

鼠标点击

使用click()函数发送虚拟鼠标点击，默认情况下在鼠标所在的位置点击左键。函数原型：

1	pyautogui .click ( x = cur_x , y = cur_y , button = 'left' )

• x，y是要点击的位置，默认是鼠标当前位置
• button是要点击的按键，有三个可选值：‘left’, ‘middle’,  ‘right’。

要在当前位置点击右键：

1 2 3

import pyautogui   pyautogui . click ( button = 'right' )

要在指定位置点击左键：

1 2 3

import pyautogui   pyautogui . click ( 100 , 100 )

click函数完成了一次鼠标点击。一次完整的点击包括两部分，按下mouseDown()和弹起mouseUp()。上面这两个函数参数和click函数一样，其实click函数只是简单的封装了mouseDown()和mouseUp()函数。

其他函数：

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

鼠标拖拽

拖拽的意思是：按下鼠标键并拖动鼠标。PyAutoGUI提供了两个函数：dragTo() 和 dragRel()。它的参数和moveTo() 和 moveRel() 一样。

注意：duration时间不能太短，拖动太快有些系统会吃不消。

使用它你可以在简单的画图程序中绘制复杂的图形。

滚轮

使用函数scroll()，它只接受一个整数。如果值为正往上滚，值为负往下滚。

1	pyautogui . scroll ( 200 )

# 定位某个按钮的位置

pyautogui有截屏功能。你可能会疑惑，它怎么还带截屏？

假如你有一个按钮要10秒种点击一下，这个任务使用上面介绍的函数可以轻松实现。但是我们假设你每次点击这个按钮它都会变换一个位置（随机），这时你该怎么办？下面我们就来解决这个问题。

首先看一下怎么使用pyautogui截屏：

1 2 3 4 5 6 7 8 9 10 11

import pyautogui   im = pyautogui . screenshot ( )   # 获得某个坐标的像素 im . getpixel ( ( 50 , 200 ) ) # (30, 132, 153)   # 判断屏幕坐标的像素是不是等于某个值 pyautogui . pixelMatchesColor ( 50 , 200 , ( 30 , 132 , 153 ) ) # True

小测试：实时获得鼠标所在位置的像素值。

现在我们来解决前面提出的问题。问题的关键是怎么找到按钮所在的坐标。其实很简单，首先对你要点击的按钮截个图，就叫button.png吧。然后使用locateOnScreen函数找到按钮所在的位置：

1 2 3

import pyautogui pyautogui . locateOnScreen ( 'button.png' ) # (643, 745, 70, 29)

locateOnScreen其实就是简单的颜色对比，如果有一个像素不匹配，它就会返回None。这个函数返回了匹配图形的坐标，找到中间点：

1 2	x , y = pyautogui .center ( ( 643 , 745 , 70 , 29 ) )    # 获得中心点 pyautogui .click ( x , y )

• locateAllOnScreen()：找到所有匹配的位置坐标。

# 键盘按键

前面是鼠标相关，下面我们看看键盘。

输入字符串

pyautogui.typewrite()：

1 2 3 4

import pyautogui   pyautogui . click ( 100 , 100 ) pyautogui . typewrite ( 'Hello world!' )

上面的字符串是一次输入，为了唬人可以延迟输入：

1	typewrite ( 'Hello world!' , 0.25 )

PyAutoGUI输入单个字符还可以，但是一些特殊字符怎么办呢？例如上面输入完Hello World，然后换行继续输入。

PyAutoGUI键盘表：

‘enter’(或‘return’ 或 ‘\n’)	回车
‘esc’	ESC键
‘shiftleft’, ‘shiftright’	左右SHIFT键
‘altleft’, ‘altright’	左右ALT键
‘ctrlleft’, ‘ctrlright’	左右CTRL键
‘tab’ (‘\t’)	TAB键
‘backspace’, ‘delete’	BACKSPACE 、DELETE键
‘pageup’, ‘pagedown’	PAGE UP 和 PAGE DOWN键
‘home’, ‘end’	HOME 和 END键
‘up’, ‘down’, ‘left’, ‘right’	箭头键
‘f1’, ‘f2’, ‘f3’….	F1…….F12键
‘volumemute’, ‘volumedown’, ‘volumeup’	有些键盘没有
‘pause’	PAUSE键
‘capslock’, ‘numlock’, ‘scrolllock’	CAPS LOCK, NUM LOCK, 和 SCROLLLOCK 键
‘insert’	INS或INSERT键
‘printscreen’	PRTSC 或 PRINT SCREEN键
‘winleft’, ‘winright’	Win键
‘command’	Mac OS X command键

1 2 3 4 5

import pyautogui   pyautogui . click ( 100 , 100 ) pyautogui . typewrite ( 'Hello world!' , 0.25 ) pyautogui . typewrite ( [ 'enter' , 'a' , 'b' , 'left' , 'left' , 'X' , 'Y' ] , '0.25' )

按键的按下和释放

和鼠标按键非常类似。

• keyDown()：按下某个键
• keyUp()：松开某个键
• press()：一次完整的击键，前面两个函数的组合。

alt＋F4：

1 2 3

pyautogui .keyDown ( 'altleft' ) ; pyautogui .press ( 'f4' ) ; pyautogui .keyUp ( 'altleft' )

也可以直接使用热键函数：

1	pyautogui . hotkey ( 'altleft' , 'f4' )