PyAutoGUI模块非常全的详解

admin 管理员组

文章数量: 887006

目录

安装

暂停和自动防故障装置、注销

坐标的概念

获取屏幕分辨率

获取鼠标指针位置

鼠标指针交互

移动鼠标指针

单击/双击鼠标

左键单击

左键双击

右键单击

中键单击

拖动鼠标

滚动鼠标

MouseInfo

建议

获取窗口信息

该对象的所有属性：

操纵窗口

返回布尔值的参数

更改窗口的状态的方法

两个常用的函数

获取窗口的其他方法

没用的函数

写代码时和运行时请注意

我的模块使用经历

PyAutoGUI模块是Python专属的图形用户界面自动化的技术（简称GUI自动化）的模块，全自动控制您的键盘、鼠标，让重复工作更轻松！各种GUI属性、信息轻松获取。

文档结尾有我的使用经历。本文虽由小盆友制作，但制作精良。

先跟大家说一下，我最近在忙C++和CSP比赛的事情，导致更新慢甚至不更新，非常抱歉。

注意：实用性考虑，本文主要面向Windows系统，macOS、Linus系统的我还不太了解，粉丝破百后我考虑更新一下。

安装

安装方式很简单，直接使用pip安装即可：

pip install pyautogui

使用清华源安装PyAutoGUI模块（加速安装，同时还能降低安装失败的概率）：

pip install -i https://pypi.tuna.tsinghua.edu/simple pyautogui

本文绝大部分代码都将模块导入部分删去了，请在你的代码中加入如下代码导入PyAutoGUI模块：

import pyautogui

其他导入方式有：

from pyautogui import *

import pyautogui as g

暂停和自动防故障装置、注销

如果你的程序出现错误，例如写错了一个坐标、流氓软件弹出了个窗口，且无法使用键盘或鼠标关闭程序。请在（默认为）0.1秒（根据你的pyautogui.PAUSE参数设置的数字，你可以手动更改）内快速将鼠标移动到屏幕的四个角落之一。如果你将pyautogui.FAILSAFE设置为False（默认为True），以上防故障装置会关闭，该方法失效，现在唯一的方法是——注销。Windows操作系统按Ctrl+Alt+Delete屏幕就会变黑，此时程序无法控制鼠标键盘，单击中间的注销按钮即可注销。（注销操作会关闭计算机中的所有程序，建议在注销前保存工作并关闭所有应用程序）

更改pyautogui.PAUSE的代码（0更改为你想要的秒数，int或float）：

pyautogui.PAUSE = 0

关闭防故障装置的代码：

pyautogui.FAILSAFE = False

坐标的概念

屏幕的最左边的最上边（左上角）的坐标是（0,0），向右x坐标递增，向左x坐标递减，向下y坐标递增，向上y坐标递减。屏幕坐标没有负数，都是正整数。

获取屏幕分辨率

建议在代码开头检测屏幕分辨率，若分辨率与你想要的分辨率不一样，就弹出警告窗口等防止代码运行时出现问题。

wh = pyautogui.size() # 返回一个Size对象，比如：Size(width=1920, height=1080)
print(wh[0]) # 输出x坐标
print(wh[1]) # 输出y坐标
print(wh.width) # 输出x坐标
print(wh.height) # 输出y坐标

获取鼠标指针位置

p = pyautogui.position() # 返回Point对象，比如：Point(x=500, y=500)
print(p[0]) # 输出x坐标
print(p[1]) # 输出y坐标
print(p.x) # 输出x坐标
print(p.y) # 输出y坐标

鼠标指针交互

移动鼠标指针

相对于当前位置移动鼠标指针（x、y为整数，正数负数都可以）。其中duration参数是可选的，它表示鼠标移动到这个位置所需要的时间，默认为0，可以为正浮点数或正整数，单位为秒（s）。

pyautogui.move(x, y, duration=time)

用屏幕坐标移动鼠标指针，在move函数后面加上To就是moveTo函数。duration参数与move函数一样

pyautogui.moveTo(x, y, duration=time)

单击/双击鼠标

这个功能有很多效果一样的代码，大家可以根据自己的喜好选择。

左键单击

pyautogui.click(x, y)

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

左键双击

pyautogui.doubleClick(x, y)

右键单击

pyautogui.click(x, y, button='right')

pyautogui.rightClick(x, y)

中键单击

pyautogui.click(x, y, button='middle')

pyautogui.middleClick(x, y)

拖动鼠标

其参数和click函数差不多，这里不在多叙述。

pyautogui.drag(x, y, duration=time) # 相对于当前位置拖动鼠标指针
pyautogui.dragTo(x, y, duration=time) # 用屏幕坐标拖动鼠标指针

滚动鼠标

向scroll函数传入的参数如果是正整数，表示向上滚动。反之向下滚动。

pyautogui.scroll(number)

MouseInfo

MouseInfo是一个应用程序，它是PyAutoGUI的一部分。它方便了你开发与鼠标相关的程序，很实用。缺点是全英文，小白可能看不懂。

翻译（没图片，大家凑合着看，注意，这个翻译是自己翻译的，稍有改动以便理解）：

复制 日志 帮助
————————————————————————————
3秒，按钮延迟  复制所有（F1） 将所有保存在日志文件内（F5）
XY坐标 2678,1172 复制XY坐标（F2） 将XY坐标保存在日志文件内（F6）
RGB颜色 90,0,0 复制RGB颜色（F3） 将RGB颜色保存在日志文件内（F7）
十六进制（H）RGB颜色 #5A0000 复制十六进制RGB颜色（F4） 将十六进制RGB颜色保存在日志文件内（F8）
颜色 <颜色>
XY 原点 0,0
<日志文件内容>
日志文件地址 保存日志文件
屏幕截图文件地址 截取整个屏幕并保存屏幕截图文件
屏幕文件保存于<屏幕截图文件地址>

打开代码如下：（建议使用交互式环境）

pyautogui.mouseInfo()

他的窗口看起来像这样：

建议

在开发过程中，建议不要通过屏幕坐标操作，最好使用图像识别，代码如下：

try:

    image = pyautogui.locateOnScreen("你的图片路径.png")

except:

    print("错误：未找到该图像")

但这样做有很大的缺陷，一旦修改屏幕分辨率就90%会失败，或者稍微动一个像素就会导致失败。

获取窗口信息

什么是活动窗口？

当前处于前台且接受键盘输入的窗口。比如说你现在在用的浏览器的窗口。

以下代码可获取活动窗口并输出窗口标题：

fw = pyautogui.getActiveWindow()

# fw是一个Win32Window对象

print(fw.title) # 打印窗口标题

该对象的所有属性：

第一列为Win32Window对象的属性，用空格隔开。

第二列为该属性的描述。

操纵窗口

我们可以通过修改这些属性来操纵窗口，如：

fw.width = 1000

也可以发现或更改窗口的最大化，最小化和激活状态。

返回布尔值的参数

fw.isMaximized # 是否最大化

fw.isMinimized # 是否最小化

fw.isActive # 是否激活

更改窗口的状态的方法

fw.maximize() # 最大化

fw.minimize() # 最小化

fw.activate() # 激活

两个常用的函数

fw.restore() # 将窗口还原到以前的大小和位置

fw.close() # 关闭一个窗口，注意使用这种方法，因为他可能会绕过要求你在退出应用程序之前保存所做工作的所有消息对话框。

获取窗口的其他方法

pyautogui.getAllWindows() # 返回屏幕上所有可见窗口的window对象列表

pyautogui.getWindowsAt(x,y) # 返回所有包含点xy的可见窗口的Window对象列表

pyautogui.getWindowsWithTitle(title) # 返回所有标题栏中包含字符串title的可见窗口的window对象的列表

pyautogui.getActiveWindow() # 返回当前接收键盘焦点的窗口的window对象

这个模块还有pyautogui.getAlltitles()函数，该函数返回所有可见窗口的字符串列表

个人觉得没用的函数

因为第一个代码time模块早就有了，相信大家也习惯用time模块的sleep函数。第二个代吗因为是在终端输出，很不美观，你可以用rich模块轻松写一个控制台中的进度条，也可以写个for循环+tkinter模块的进度条。

pyautogui.sleep(3) # 等待3秒，与time.sleep()没什么两样

pyautogui.countdown(10) # 会每秒打印一个数字，相当于倒计时

消息框

显示消息框。（如果你有这方面的需求，tkinter模块是个更好的选择，Python自带）

pyautogui.alert(text) # 显示文本text，并有一个确定按钮

pyautogui.confirm(text) # 显示文本text，并有确定和取消按钮，根据单击的按钮返回'ok'或'Cancel'

pyautogui.prompt(text) # 显示文本text，并有一个文本字段给用户输入，它以字符串的形式返回

pyautogui.password(text) # 与prompt()相同，但会显示“*”，这样用户可以输入敏感信息，如密码等隐私信息

 他们四个还有一个可选的参数——标题，如下：

pyautogui.alert("程序执行完毕","GUI自动化程序")

写代码时和运行时请注意

1、建议每次运行代码用相同的屏幕分辨率，这样窗口的位置就不会变，你之前的截屏也能正确识别。

2、程序打开一个应用程序时建议先将其最大化，这样它的按钮等东西都在同一个地方。

3、在等待加载程序的过程中，一定要加入足够的暂停时间，如果能够检测什么时候完成就更好。

4、建议使用logging（存储日志）模块保存和保存程序所做的事情，这个模块个人觉得很实用，功能不是很多但很强大。5个不同级别的日志重要程度，可以保存至文件里。有需要的话我单独出一个博文讲。

5、使用以下代码：

pyautogui.getWindowsWithTitle(title)

来确保你认为程序正在单击的应用程序的窗口是存在的，并使用fw.activate()方法将该窗口放在前台。

6、一定要在程序中添加尽可能多的检查，万一弹出一个意外的窗口或计算机失去了网络连接，它可能会在你的电脑上到处乱点。

7、如果你不按以上就运行，我建议你一定要好好做在椅子上，万一出事了就不好搞了。
 

当你在计算机上干重复的事情，为什么不直接扔给PyAutoGUI做？看着鼠标自己移动，看着文本自动出现在屏幕上，这是彻头彻尾的催眠。为什么不用节省下来的时间，舒舒服服地坐着，看着程序为你工作？看着你聪明才智帮你完成繁琐的工作，肯定会让你感到满意！

我的模块使用经历

我曾用过这个模块全自动登录过6个网站，但是有些网站有人机校验，不使用其他技术无法全自动，但也能半自动了，这个模块配合这些模块最好用：

time：虽然PyAutoGUI模块也可以等待一段时间，但个人更习惯使用它的sleep函数。

webbrowser：与PyAutoGUI模块相似的模块，用于浏览器上的各种操作。推荐博客：WebBrowser控件的常用方法、属性和事件

subprocess：常用Popen方法打开应用程序或用应用程序打开文件。推荐博客：python常用库学习四——subprocess

logging：强烈建议使用！日志记录模块，像这种GUI自动化操作最需要的就是日志。推荐博客：Python常用模块 之 logging：日志模块

rich：强烈建议使用！GUI自动化一般都有控制台输出，它给我们带来了更美观的输出，还有进度条等功能。推荐博客：Python之rich：GUI之外，终端呈现也能玩出花

最简单的连点器应用

别问我python路径怎么这么怪，我的python是Panda3D的SDK中自带的哦~
解析：导入模块，获取鼠标指针位置，不断点击这个位置，直到按下Ctrl+Alt+Delete抛出异常结束。

都看到这儿了，还不快三一下，你要白嫖啊？那点个赞呗，谢啦。感谢大家的支持！

本文标签： 详解 模块 PyAutoGUI