### PyAutoGUI 库的完整用法、功能说明及示例教程 PyAutoGUI 是一个用于自动化控制鼠标和键盘操作的强大 Python 库。它不仅能够模拟用户交互行为，还支持图像识别等多种高级功能。以下是对其完整用法、功能说明以及示例教程的具体阐述。 --- #### 一、基本功能概述 ##### 1. 鼠标控制 PyAutoGUI 支持对鼠标的精确控制，包括移动、点击、拖拽等操作。 - **移动鼠标**： ```python import pyautogui # 将鼠标移动到坐标 (x, y)，duration 表示动画持续时间 pyautogui.moveTo(100, 200, duration=1) # 相对于当前位置移动 pyautogui.moveRel(50, -50, duration=0.5) ``` 此外还可以设置平滑过渡效果[^1]。 - **鼠标点击**： ```python pyautogui.click() # 左键单击默认位置 pyautogui.doubleClick() # 双击 pyautogui.rightClick() # 右键点击 pyautogui.middleClick() # 中键点击 ``` - **鼠标拖拽**： ```python pyautogui.dragTo(300, 400, duration=1, button='left') # 拖拽到目标位置 pyautogui.dragRel(50, -50, duration=0.5, button='right') # 相对拖拽 ``` --- ##### 2. 键盘控制 PyAutoGUI 能够模拟各种键盘输入操作，包括字符录入、热键组合等。 - **输入文本**： ```python pyautogui.write('Hello World!', interval=0.1) # 输入文字，interval 控制间隔时间 ``` - **按下/释放按键**： ```python pyautogui.press('enter') # 模拟按 Enter 键 pyautogui.keyDown('shift') # 按下 Shift 键 pyautogui.keyUp('shift') # 松开 Shift 键 ``` - **组合键**： ```python pyautogui.hotkey('ctrl', 'c') # 组合键 Ctrl+C pyautogui.hotkey('alt', 'f4') # 关闭当前窗口 Alt+F4 ``` --- ##### 3. 屏幕截图与图像识别 PyAutoGUI 提供了屏幕捕获和图像匹配的功能，可用于定位特定 UI 元素的位置。 - **截取全屏**： ```python screenshot = pyautogui.screenshot() screenshot.save('screenshot.png') # 保存图片 ``` - **图像识别**： ```python location = pyautogui.locateOnScreen('button_image.png') # 查找图片在屏幕中的位置 center = pyautogui.center(location) # 获取中心点坐标 pyautogui.click(center.x, center.y) # 自动点击该位置 ``` --- #### 二、高级功能拓展 ##### 1. 失败安全机制 为了防止脚本失控，PyAutoGUI 默认启用了失败安全模式。当鼠标移动到屏幕左上角时，会抛出异常终止程序运行。 ```python pyautogui.FAILSAFE = True # 启用（默认） # 或者禁用 FAILSAFE pyautogui.FAILSAFE = False ``` ##### 2. 实现复杂任务 通过结合鼠标、键盘和图像识别功能，可以完成复杂的自动化任务。例如批量登录 QQ 号码： ```python import pyautogui import time def login_qq(username, password): # 图像识别找到用户名输入框并点击 username_box = pyautogui.locateCenterOnScreen('username_input.png') pyautogui.click(username_box) # 输入用户名 pyautogui.write(username, interval=0.1) # 切换到密码框并输入密码 pyautogui.press('tab') pyautogui.write(password, interval=0.1) # 执行登录操作 pyautogui.press('enter') # 示例调用 login_qq('test_user', 'password123') time.sleep(5) # 等待加载完成后继续下一步 ``` --- #### 三、常见问题解决 1. **无法导入模块**：确认已正确安装 PyAutoGUI 和其依赖项。 ```bash pip install pyautogui pillow ``` 2. **图像识别失败**：确保模板图片清晰无误，并调整分辨率一致性[^2]。 3. **速度过慢**：可通过参数优化性能，如减少 `interval` 时间或增加硬件加速。 --- ### 示例代码汇总 以下是一些综合性的代码示例，帮助理解 PyAutoGUI 的实际应用场景。 #### 示例 1：自动填写表单 ```python import pyautogui pyautogui.write('John Doe', interval=0.1) # 输入姓名 pyautogui.press('tab') # 切换到下一个字段 pyautogui.write('john.doe@example.com') # 输入邮箱地址 pyautogui.press('tab') pyautogui.write('Password@123') # 输入密码 pyautogui.press('enter') # 提交表单 ``` #### 示例 2：批量处理文件 ```python import pyautogui import os files_dir = './files' for filename in os.listdir(files_dir): file_path = os.path.join(files_dir, filename) # 打开文件 pyautogui.hotkey('win', 'e') # 打开资源管理器 pyautogui.write(file_path, interval=0.1) pyautogui.press('enter') # 截图保存 pyautogui.screenshot(f'{filename}.png') pyautogui.hotkey('alt', 'f4') # 关闭窗口 ``` ---