本文详细介绍 PyAutoGUI 跨平台桌面自动化库。内容包括安装方法、鼠标操作（移动点击拖拽滚轮）、键盘输入与快捷键模拟、屏幕截图及图像识别定位技术。文章还阐述了故障安全机制以防止操作失控，并提供了基于记事本的完整自动化实战代码示例，适用于 Windows、macOS 和 Linux 系统的重复性任务处理。
PyAutoGUI 是一款跨平台（支持 Windows、macOS、Linux）的 Python 桌面自动化库，能够模拟用户的鼠标移动、点击、滚轮操作和键盘输入，还支持屏幕截图、图像识别定位等功能，广泛用于重复性桌面操作自动化（如表单填写、软件操作、批量处理等）。
直接通过 pip 命令安装，命令简洁无复杂依赖：
pip install pyautogui
补充：若安装失败（如 macOS 需额外依赖），可参考官方文档适配系统环境，Windows 系统通常可直接安装成功。
pyautogui
time
:
:
x, y = pyautogui.position()
(x, y)
time.sleep()
KeyboardInterrupt:
()
PyAutoGUI 提供了完整的鼠标模拟接口，核心包括移动、点击、拖拽等，所有操作均基于屏幕坐标系统（屏幕左上角为原点 (0, 0)，向右为 x 轴正方向，向下为 y 轴正方向）。
import pyautogui
# duration：移动耗时（秒），可选参数，默认瞬间移动
pyautogui.moveTo(x=100, y=200, duration=0.5)
# 向右移动 50 像素，向下移动 30 像素，耗时 0.3 秒
pyautogui.moveRel(dx=50, dy=30, duration=0.3)
# 在 (100, 200) 位置单击左键，duration 为移动到目标位置的耗时
pyautogui.click(x=100, y=200, duration=0.2)
# 右键单击
pyautogui.click(x=100, y=200, button='right', duration=0.2)
# 中键单击
pyautogui.click(x=100, y=200, button='middle', duration=0.2)
# 左键双击
pyautogui.doubleClick(x=100, y=200, duration=0.2)
# 左键三击
pyautogui.tripleClick(x=100, y=200, duration=0.2)
模拟鼠标按住并拖动的行为，常用于文件拖拽、窗口调整等场景：
# 从 (x1, y1) 拖拽到 (x2, y2)，按住左键拖拽
pyautogui.dragTo(x=300, y=400, duration=0.8, button='left')
# 相对拖拽：基于当前位置偏移拖拽
pyautogui.dragRel(dx=100, dy=50, duration=0.5, button='left')
模拟滚轮滚动行为，clicks 参数指定滚动幅度（正数向上滚，负数向下滚）：
# 向下滚动 5 格（负数表示向下）
pyautogui.scroll(clicks=-5, x=100, y=200)
# 向上滚动 3 格（正数表示向上）
pyautogui.scroll(clicks=3, x=100, y=200)
使用 typewrite() 方法输入字符串，支持指定输入间隔（模拟人工输入速度）：
# 直接输入文本
pyautogui.typewrite("Hello, PyAutoGUI!")
# 带间隔输入（每个字符间隔 0.2 秒）
pyautogui.typewrite("Hello, PyAutoGUI!", interval=0.2)
对于回车键、空格键、快捷键等特殊按键，需使用按键名称（封装在 PyAutoGUI 中），核心方法：
# 单个特殊按键：按下并释放回车键
pyautogui.press('enter')
# 组合快捷键：Ctrl + C（复制）
pyautogui.keyDown('ctrl')
pyautogui.press('c')
pyautogui.keyUp('ctrl')
# 简化组合快捷键：使用 hotkey() 方法（推荐）
pyautogui.hotkey('ctrl', 'c') # 复制
pyautogui.hotkey('ctrl', 'v') # 粘贴
pyautogui.hotkey('ctrl', 'a') # 全选
常用特殊按键名称：enter（回车）、space（空格）、backspace（删除）、tab（制表符）、shift、ctrl、alt 等。
获取屏幕分辨率（用于确定坐标范围）：
# 获取屏幕宽度和高度
screen_width, screen_height = pyautogui.size()
print(f"屏幕分辨率：{screen_width} × {screen_height}")
# 获取当前鼠标位置坐标
mouse_x, mouse_y = pyautogui.position()
print(f"当前鼠标位置：({mouse_x}, {mouse_y})")
PyAutoGUI 支持通过目标图像（如按钮截图、图标截图），自动查找其在屏幕上的坐标，核心方法 locateOnScreen()。
步骤说明：
import pyautogui
import time
# 等待 3 秒，预留时间切换到目标屏幕
time.sleep(3)
try:
# 查找目标图像（image.png 为目标截图路径）
# confidence：匹配精度（0-1，默认 1，降低精度可提高查找成功率，需安装 opencv-python 支持）
target_location = pyautogui.locateOnScreen('image.png', confidence=0.8)
if target_location:
# 获取目标图像的中心坐标
target_center = pyautogui.center(target_location)
print(f"目标图像位置：{target_location}，中心坐标：{target_center}")
# 点击目标中心
pyautogui.click(target_center.x, target_center.y, duration=0.2)
else:
print("未找到目标图像")
except Exception as e:
print(f"查找失败：{e}")
注意：使用 confidence 参数时，需额外安装 opencv-python：pip install opencv-python
# 截取整个屏幕并保存为文件
pyautogui.screenshot('full_screen.png')
# 截取指定区域屏幕（x1, y1, 宽度，高度）
pyautogui.screenshot('partial_screen.png', region=(100, 100, 300, 200))
PyAutoGUI 提供了关键的安全保护机制，避免自动化操作失控（如鼠标移到屏幕边缘无法找回、无限循环操作等）：
默认开启：当鼠标移动到屏幕左上角（坐标 (0, 0)）时，会立即抛出 FailSafeException 异常，终止所有自动化操作：
# 若操作失控，快速将鼠标移到屏幕左上角即可停止程序
try:
while True:
pyautogui.moveRel(10, 0, duration=0.1)
except pyautogui.FailSafeException:
print("故障安全机制触发，程序终止")
通过 PAUSE 属性设置所有 PyAutoGUI 操作的默认间隔时间（秒），便于观察操作过程，也可防止操作过快导致程序异常：
# 设置所有操作间隔 0.5 秒
pyautogui.PAUSE = 0.5
import pyautogui
import time
# 安全设置
pyautogui.PAUSE = 0.5 # 操作间隔 0.5 秒
pyautogui.FAILSAFE = True # 开启故障安全机制
# 1. 等待 5 秒，预留时间打开记事本
print("5 秒后开始操作，请打开记事本...")
time.sleep(5)
# 2. 输入文本
pyautogui.typewrite("Python 自动化 - PyAutoGUI 实战", interval=0.1)
# 3. 换行
pyautogui.press('enter')
# 4. 输入第二行文本
pyautogui.typewrite("这是一个简单的自动化演示", interval=0.1)
# 5. 全选文本（Ctrl + A）
pyautogui.hotkey('ctrl', 'a')
# 6. 复制文本（Ctrl + C）
pyautogui.hotkey('ctrl', 'c')
# 7. 弹窗提示操作完成
pyautogui.alert("自动化操作完成！")
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online