pyautogui库的使用及说明

pyautogui 是一个强大的 Python 库，用于自动化控制鼠标和键盘，常用于 GUI 自动化测试、游戏脚本、办公自动化等场景。

1. 安装 pyautogui

pip install pyautogui

注意：在 Linux 系统上，可能需要额外安装依赖：
sudo apt-get install scrot  # 用于截图（Linux）
sudo apt-get install python3-tk  # 用于 GUI 支持
sudo apt-get install python3-dev  # 用于开发支持

2. 基本功能

(1) 鼠标控制

① 获取鼠标位置

import pyautogui

x, y = pyautogui.position()  # 获取当前鼠标坐标
print(f"当前鼠标位置: ({x}, {y})")

② 移动鼠标

pyautogui.moveTo(100, 200, duration=1)  # 移动到 (100, 200)，耗时 1 秒
pyautogui.moveRel(50, 50, duration=0.5)  # 相对当前位置移动 (50, 50)，耗时 0.5 秒

③ 点击鼠标

pyautogui.click()  # 当前位置单击左键
pyautogui.click(100, 200)  # 在 (100, 200) 单击左键
pyautogui.doubleClick()  # 双击左键
pyautogui.rightClick()  # 右键单击
pyautogui.middleClick()  # 中键单击
pyautogui.click(button='right')  # 指定按钮点击

④ 拖动鼠标

pyautogui.dragTo(300, 400, duration=1)  # 拖动到 (300, 400)
pyautogui.dragRel(100, 100, duration=0.5)  # 相对拖动

⑤ 滚动鼠标

pyautogui.scroll(10)  # 向上滚动 10 个单位
pyautogui.scroll(-10)  # 向下滚动 10 个单位

(2) 键盘控制

① 输入文本

pyautogui.write("Hello, World!", interval=0.1)  # 输入文本，每个字符间隔 0.1 秒

② 按键操作

pyautogui.press('enter')  # 按 Enter 键
pyautogui.press(['ctrl', 'c'])  # 组合键 Ctrl + C
pyautogui.hotkey('ctrl', 'v')  # 快捷键 Ctrl + V（推荐）

③ 按住和释放按键

pyautogui.keyDown('shift')  # 按住 Shift
pyautogui.press('4')  # 按 4（会输入 $）
pyautogui.keyUp('shift')  # 释放 Shift

(3) 屏幕操作

① 截图

screenshot = pyautogui.screenshot()  # 截取全屏
screenshot.save('screenshot.png')  # 保存截图

# 截取指定区域 (left, top, width, height)
region_screenshot = pyautogui.screenshot(region=(0, 0, 300, 400))
region_screenshot.save('region.png')

② 查找图片（定位 UI 元素）

button_location = pyautogui.locateOnScreen('button.png')  # 查找图片位置
if button_location:
    print(f"找到按钮，位置: {button_location}")
    pyautogui.click(button_location)  # 点击找到的按钮
else:
    print("未找到按钮")

注意：

图片要完全匹配（包括颜色、分辨率）。

可以调整 confidence 参数（需要 opencv-python）：pyautogui.locateOnScreen('button.png', confidence=0.8) # 匹配相似度 80%

③ 获取屏幕尺寸

screen_width, screen_height = pyautogui.size()
print(f"屏幕尺寸: {screen_width} x {screen_height}")

(4) 安全措施（防止失控）

pyautogui 默认不会自动停止，如果脚本失控，可以：

手动停止：快速移动鼠标到屏幕角落（如 (0, 0) 或 (屏幕宽度, 屏幕高度)），pyautogui 会抛出 pyautogui.FailSafeException 并停止执行。
禁用安全措施（不推荐）： pyautogui.FAILSAFE = False # 关闭鼠标失控保护
设置暂停时间（推荐）： pyautogui.PAUSE = 0.5 # 每个动作后暂停 0.5 秒

3. 常见应用场景

(1) 自动化办公

自动填写表单、发送邮件、批量处理 Excel/Word。
示例：自动输入密码（谨慎使用）： pyautogui.write('my_password', interval=0.1) pyautogui.press('enter')

(2) 游戏脚本

自动点击、按键（但可能违反游戏规则）。
示例：自动点击游戏按钮： while True: pyautogui.click(100, 200) # 持续点击 (100, 200)

(3) GUI 自动化测试

模拟用户操作，测试软件功能。

4. 总结

功能	方法	示例
鼠标移动	`moveTo(x, y)` / `moveRel(dx, dy)`	`pyautogui.moveTo(100, 200)`
鼠标点击	`click()` / `doubleClick()` / `rightClick()`	`pyautogui.click(100, 200)`
鼠标拖动	`dragTo(x, y)` / `dragRel(dx, dy)`	`pyautogui.dragTo(300, 400)`
鼠标滚动	`scroll(amount)`	`pyautogui.scroll(10)`
键盘输入	`write(text)`	`pyautogui.write("Hello")`
按键操作	`press(key)` / `hotkey(keys)`	`pyautogui.press('enter')`
截图	`screenshot()`	`pyautogui.screenshot().save('img.png')`
查找图片	`locateOnScreen('image.png')`	`pyautogui.locateOnScreen('button.png')`
安全措施	`FAILSAFE = True` / `PAUSE = 0.5`	`pyautogui.PAUSE = 0.5`