Python PyAutoGUI超详细实战教程 附完整教学代码

# 基础安装（推荐，自动安装所有依赖）
pip install pyautogui

# 国内镜像源安装（解决下载慢问题，阿里云/清华源二选一）
pip install pyautogui -i https://mirrors.aliyun.com/pypi/simple/
pip install pyautogui -i https://pypi.tuna.tsinghua.edu.cn/simple/

import pyautogui
# 打印PyAutoGUI版本，验证库导入成功
print("PyAutoGUI版本：", pyautogui.__version__)

import pyautogui

# 1. 紧急终止：将鼠标移到屏幕左上角（坐标(0,0)），会触发PyAutoGUIException，终止所有操作
pyautogui.FAILSAFE = True  # 默认开启，建议保持True

# 2. 操作延迟：所有键鼠操作后添加N秒延迟，避免操作过快（单位：秒）
pyautogui.PAUSE = 0.5  # 建议设置0.5-1秒，兼顾效率和稳定性

# 3. 鼠标缓动：设置鼠标移动的平滑度，0为瞬间移动，1为最平滑（可选）
pyautogui.MINIMUM_DURATION = 0.1  # 鼠标移动最短时间
pyautogui.MAXIMUM_DURATION = 0.5  # 鼠标移动最长时间

# 1. 获取屏幕分辨率（返回元组：(宽度, 高度)）
screen_width, screen_height = pyautogui.size()
print(f"屏幕分辨率：{screen_width}×{screen_height}")

# 2. 获取当前鼠标坐标（返回元组：(x, y)）
x, y = pyautogui.position()
print(f"当前鼠标坐标：X={x}, Y={y}")

# 3. 暂停执行（类似time.sleep()，更贴合PyAutoGUI使用场景）
pyautogui.sleep(2)  # 暂停2秒

import pyautogui

# 1. 绝对移动：移到屏幕正中央（基于屏幕分辨率计算）
screen_w, screen_h = pyautogui.size()
center_x, center_y = screen_w / 2, screen_h / 2
pyautogui.moveTo(center_x, center_y, duration=0.8)  # duration：移动耗时，0.8秒（可选）

# 2. 相对移动：从当前位置向右移动100像素，向下移动50像素
pyautogui.moveRel(100, 50, duration=0.5)

# 3. 瞬间移动：去掉duration参数，鼠标瞬间到达指定位置
pyautogui.moveTo(100, 100)

import pyautogui

# 1. 左键单击：移到(200,200)并点击（默认左键）
pyautogui.click(200, 200, duration=0.5)

# 2. 右键单击：移到(300,300)并右击
pyautogui.click(300, 300, button='right', duration=0.5)

# 3. 左键双击：移到(400,400)，双击，间隔0.2秒
pyautogui.click(400, 400, clicks=2, interval=0.2, duration=0.5)

# 4. 中键单击（滚轮点击）：移到(500,500)并点击中键
pyautogui.click(500, 500, button='middle', duration=0.5)

# 专用点击函数（简化版，功能与click一致）
pyautogui.leftClick(600, 600)  # 左键单击
pyautogui.rightClick(700, 700) # 右键单击
pyautogui.doubleClick(800, 800)# 左键双击

import pyautogui

# 移到(100,100)，按下左键→暂停1秒→松开左键（模拟长按1秒）
pyautogui.moveTo(100, 100, duration=0.5)
pyautogui.mouseDown(button='left')  # 按下左键
pyautogui.sleep(1)
pyautogui.mouseUp(button='left')    # 松开左键

# 右键长按：移到(200,200)，按下右键→松开右键
pyautogui.moveTo(200, 200, duration=0.5)
pyautogui.mouseDown(button='right')
pyautogui.mouseUp(button='right')

import pyautogui

# 1. 绝对拖拽：从(100,100)拖到(500,500)（按住左键）
pyautogui.moveTo(100, 100, duration=0.5)
pyautogui.dragTo(500, 500, button='left', duration=0.8)

# 2. 相对拖拽：从当前位置向右拖300像素，向上拖100像素（按住左键）
pyautogui.dragRel(300, -100, button='left', duration=0.5)

# 3. 右键拖拽（少数场景用，如文件右键拖拽复制）
pyautogui.moveTo(200, 200, duration=0.5)
pyautogui.dragTo(600, 600, button='right', duration=0.8)

import pyautogui

# 移到屏幕中央，再操作滚轮
screen_w, screen_h = pyautogui.size()
pyautogui.moveTo(screen_w/2, screen_h/2, duration=0.5)

# 1. 向上滑动滚轮（刻度数10）
pyautogui.scroll(10)

# 2. 向下滑动滚轮（刻度数20，滑动距离更大）
pyautogui.scroll(-20)

# 3. 连续向下滑动：循环3次，每次滑10刻度
for _ in range(3):
    pyautogui.scroll(-10)
    pyautogui.sleep(0.3)

import pyautogui

# 先打开一个记事本/文本框（手动操作，或后续用窗口自动化）
pyautogui.sleep(3)  # 预留3秒，手动点击输入框

# 1. 快速输入文字（无间隔）
pyautogui.typewrite("Hello PyAutoGUI!")

# 2. 模拟手动打字（每个字符间隔0.1秒）
pyautogui.typewrite("Python自动化入门", interval=0.1)

# 3. 换行输入+组合文字
pyautogui.typewrite("\n")  # 换行（转义字符有效）
pyautogui.typewrite("坐标(0,0)是屏幕左上角", interval=0.05)

import pyautogui

pyautogui.sleep(3)  # 预留3秒，点击输入框

# 输入文字→按回车→按空格→按退格
pyautogui.typewrite("测试特殊按键")
pyautogui.press("enter")  # 回车
pyautogui.press("space")  # 空格
pyautogui.press("backspace")  # 退格
pyautogui.press("delete")     # 删除

import pyautogui

pyautogui.sleep(3)

# 长按Shift→输入大写字母→松开Shift（模拟大写输入）
pyautogui.keyDown("shift")
pyautogui.typewrite("hello")  # 输出HELLO
pyautogui.keyUp("shift")

# 长按方向键右→移动光标5次→松开
for _ in range(5):
    pyautogui.keyDown("right")
    pyautogui.sleep(0.1)
pyautogui.keyUp("right")

import pyautogui

pyautogui.sleep(3)  # 预留3秒，打开文本并输入内容

# 1. 全选：Ctrl+A（Windows/Mac通用，Mac的Ctrl实际是command，可直接用ctrl）
pyautogui.hotkey("ctrl", "a")

# 2. 复制：Ctrl+C
pyautogui.hotkey("ctrl", "c")

# 3. 粘贴：Ctrl+V
pyautogui.hotkey("ctrl", "v")

# 4. 保存：Ctrl+S
pyautogui.hotkey("ctrl", "s")

# 5. 关闭窗口：Alt+F4（Windows）/ Command+Q（Mac）
# pyautogui.hotkey("alt", "f4")

# 6. 截图：PrintScreen（Windows）
# pyautogui.hotkey("printscreen")

import pyautogui

# 1. 全屏截图并保存为文件
screenshot1 = pyautogui.screenshot("full_screen.png")  # 保存到当前目录，命名为full_screen.png

# 2. 指定区域截图：(x1, y1, 宽度, 高度)，从(100,100)开始，宽400像素，高300像素
screenshot2 = pyautogui.screenshot("area_screen.png", region=(100, 100, 400, 300))

# 3. 截图不保存，仅获取图像对象（用于后续像素识别/图像定位）
screen_img = pyautogui.screenshot()

import pyautogui

# 1. 获取指定坐标的像素颜色
color = pyautogui.pixel(200, 200)
print(f"坐标(200,200)的像素颜色：R={color[0]}, G={color[1]}, B={color[2]}")

# 2. 判断像素颜色是否匹配（严格匹配）
is_match = pyautogui.pixelMatchesColor(200, 200, (255, 255, 255))  # 白色
print(f"是否为白色：{is_match}")

# 3. 带容差的匹配（容差tolerance=10，允许RGB各通道偏差±10）
is_match2 = pyautogui.pixelMatchesColor(200, 200, (255, 255, 255), tolerance=10)
print(f"带容差是否为白色：{is_match2}")

import pyautogui

# 注意：target.png为目标截图，需与脚本同目录，confidence设置0.8（匹配精度）
# 若提示找不到图片，可降低confidence至0.7，或重新截图（确保目标清晰、无遮挡）

try:
    # 1. 定位目标中心坐标
    target_x, target_y = pyautogui.locateCenterOnScreen("target.png", confidence=0.8)
    print(f"目标中心坐标：({target_x}, {target_y})")

    # 2. 点击目标（智能定位+点击，无需固定坐标）
    pyautogui.click(target_x, target_y, duration=0.5)

    # 3. 查找所有匹配的目标并依次点击
    all_targets = pyautogui.locateAllOnScreen("target.png", confidence=0.8)
    for target in all_targets:
        # 获取每个目标的中心坐标
        center_x, center_y = pyautogui.center(target)
        pyautogui.click(center_x, center_y, duration=0.3)
        pyautogui.sleep(0.5)

except pyautogui.ImageNotFoundException:
    # 捕获图片未找到异常，避免程序崩溃
    print("未找到目标图片，请检查截图是否正确、目标是否在屏幕上")

import pyautogui

# 1. 提示弹窗（只有确定按钮）
pyautogui.alert(text="自动化操作即将开始！", title="提示", button="确定")

# 2. 确认弹窗（确定/取消按钮，返回点击的按钮文字）
result = pyautogui.confirm(text="是否继续执行自动化？", title="确认", buttons=["确定", "取消"])
if result == "确定":
    print("执行自动化操作")
else:
    print("取消自动化操作")

# 3. 输入弹窗（返回输入的文字，取消则返回None）
input_text = pyautogui.prompt(text="请输入要输入的内容：", title="输入", default="默认文字")
if input_text:
    print(f"你输入的内容：{input_text}")

# 4. 密码弹窗（输入内容隐藏，返回输入的密码，取消则返回None）
pwd = pyautogui.password(text="请输入密码：", title="密码验证", default="", mask="*")
print(f"你输入的密码：{pwd}")

import pyautogui

# 设置全局配置
pyautogui.FAILSAFE = True
pyautogui.PAUSE = 0.5

# 批量执行10次点击操作（模拟批量处理）
try:
    for i in range(1, 11):
        # 定位目标并点击
        target_x, target_y = pyautogui.locateCenterOnScreen("target.png", confidence=0.8)
        pyautogui.click(target_x, target_y)
        print(f"第{i}次操作完成")
        # 每5次操作暂停2秒，防检测
        if i % 5 == 0:
            pyautogui.sleep(2)
except pyautogui.ImageNotFoundException:
    print("未找到目标，停止批量操作")
except Exception as e:
    print(f"操作失败，错误信息：{e}")
finally:
    pyautogui.alert(text="批量操作结束！", title="完成", button="确定")

import pyautogui
import random

# 随机延迟+缓动移动，模拟人类操作
pyautogui.FAILSAFE = True
pyautogui.PAUSE = random.uniform(0.3, 0.7)  # 随机全局暂停

# 移到屏幕中央（随机耗时0.3-0.9秒）
screen_w, screen_h = pyautogui.size()
pyautogui.moveTo(screen_w/2, screen_h/2, duration=random.uniform(0.3, 0.9))

# 点击目标（随机延迟后点击）
pyautogui.sleep(random.uniform(0.2, 0.5))
pyautogui.click(duration=0.2)

import pyautogui
import random
import time

# ===================== 全局配置 =====================
pyautogui.FAILSAFE = True  # 紧急终止
pyautogui.PAUSE = random.uniform(0.4, 0.8)  # 随机操作间隔，防检测
CONFIDENCE = 0.75  # 图像匹配精度
SAVE_PATH = "桌面"  # 保存路径（Windows）

# ===================== 工具函数 =====================
def random_sleep(min_t=0.2, max_t=0.6):
    """随机暂停，模拟人类操作"""
    time.sleep(random.uniform(min_t, max_t))

def click_target(image_path):
    """智能定位并点击目标，返回是否成功"""
    try:
        x, y = pyautogui.locateCenterOnScreen(image_path, confidence=CONFIDENCE)
        pyautogui.moveTo(x, y, duration=random.uniform(0.3, 0.7))
        random_sleep()
        pyautogui.click()
        return True
    except pyautogui.ImageNotFoundException:
        print(f"未找到目标：{image_path}")
        return False

# ===================== 主程序 =====================
if __name__ == "__main__":
    # 提前截图：start_menu.png（开始菜单图标）、notepad.png（记事本搜索结果）、save.png（保存按钮）
    # 确保截图保存在脚本同目录，目标无遮挡

    try:
        # 1. 点击Windows开始菜单
        if not click_target("start_menu.png"):
            raise Exception("打开开始菜单失败")
        random_sleep(0.5, 1.0)

        # 2. 输入“记事本”并回车启动
        pyautogui.typewrite("记事本", interval=random.uniform(0.1, 0.2))
        random_sleep()
        pyautogui.press("enter")
        random_sleep(1.0, 1.5)  # 等待记事本启动

        # 3. 批量新建10个笔记
        for i in range(1, 11):
            # 写入内容
            content = f"这是第{i}个记事本文件，由PyAutoGUI自动化生成！\n生成时间：{time.strftime('%Y-%m-%d %H:%M:%S')}"
            pyautogui.typewrite(content, interval=random.uniform(0.05, 0.1))
            random_sleep()

            # 快捷键保存：Ctrl+S
            pyautogui.hotkey("ctrl", "s")
            random_sleep(0.8, 1.2)  # 等待保存窗口弹出

            # 输入文件名并保存
            pyautogui.typewrite(f"笔记{i}.txt", interval=random.uniform(0.1, 0.2))
            random_sleep()
            pyautogui.press("enter")
            random_sleep()

            # 新建空白记事本：Ctrl+N
            pyautogui.hotkey("ctrl", "n")
            random_sleep(0.5, 1.0)

        # 4. 关闭记事本：Alt+F4
        pyautogui.hotkey("alt", "f4")
        pyautogui.alert(text="批量操作完成！\n共生成10个记事本文件，保存至桌面", title="成功", button="确定")

    except Exception as e:
        pyautogui.alert(text=f"操作失败！\n错误信息：{str(e)}", title="失败", button="确定")
        print(f"程序异常：{e}")