【PyAutoGUI 函数库完整指南】

原创

于 2025-10-11 16:48:23 发布 · 437 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#开发语言 #pyautogui

PyAutoGUI 函数库完整指南

PyAutoGUI 是一个强大的 Python 库，可以让您的程序控制鼠标和键盘来自动化 GUI 应用程序的操作。本指南基于实际项目示例，详细介绍如何使用 PyAutoGUI 实现各种自动化任务。

安装

pip install pyautogui

对于图像识别功能，还需要安装 Pillow：

pip install pillow

基本概念

导入库

import pyautogui
import time  # 通常与 time 模块一起使用

安全机制

PyAutoGUI 有一个内置的安全机制：当鼠标移动到屏幕左上角 (0,0) 时，程序会抛出 FailSafeException 异常来停止执行。

# 禁用安全机制（不推荐）
pyautogui.FAILSAFE = False

# 设置操作间隔（推荐）
pyautogui.PAUSE = 1  # 每次操作后暂停1秒

鼠标控制

1. 获取鼠标位置

# 获取当前鼠标坐标
position = pyautogui.position()
print(f"当前鼠标坐标为：{
     
     position}")

# 获取 x, y 坐标
x, y = pyautogui.position()
print(f"X: {
     
     x}, Y: {
     
     y}")

实际应用示例（来自 fun1.py）：

import pyautogui
import time

print("将鼠标移动到目标位置，5秒后获取坐标...")

while True:
    time.sleep(0.5)  # 等待0.5秒
    position = pyautogui.position()  # 获取当前鼠标位置
    print(f"当前鼠标坐标为：{
     
     position}")

2. 移动鼠标

# 移动到指定坐标
pyautogui.moveTo(x, y)

# 带动画效果的移动
pyautogui.moveTo(x, y, duration=1)  # 1秒内移动到目标位置

# 相对移动
pyautogui.move(100, 50)  # 向右移动100像素，向下移动50像素

3. 鼠标点击

# 单击
pyautogui.click()  # 在当前位置单击
pyautogui.click(x, y)  # 在指定位置单击

# 双击
pyautogui.doubleClick()
pyautogui.doubleClick(x, y)

# 右键单击
pyautogui.rightClick()
pyautogui.rightClick(x, y)

# 指定鼠标按钮
pyautogui.click(button='left')   # 左键
pyautogui.click(button='right')  # 右键
pyautogui.click(button='middle') # 中键

4. 拖拽操作

# 拖拽到指定位置
pyautogui.drag(100

最低0.47元/天解锁文章