Python中PyAutoGUI?庫的使用

更新時間：2025年04月25日 11:20:29 作者：wanglaqqqq

PyAutoGUI?是?Python?生態(tài)中??功能最全面的圖形界面自動化庫,通過模擬鼠標、鍵盤操作和屏幕圖像識別,本文就來介紹一下Python中PyAutoGUI庫的使用,感興趣的可以了解一下

一、PyAutoGUI 庫簡介

PyAutoGUI 是 Python 生態(tài)中 ?功能最全面的圖形界面自動化庫，通過模擬鼠標、鍵盤操作和屏幕圖像識別，實現(xiàn)跨平臺（Windows/macOS/Linux）的自動化任務(wù)。其核心價值在于：

?解放重復(fù)勞動：自動化數(shù)據(jù)錄入、文件整理、報表生成等耗時操作，效率提升 90% 以上。
?精準控制能力：支持像素級坐標定位（誤差 ±0.5 像素）、亞秒級操作延遲（可配置 0.01 秒精度）。
?智能圖像識別：通過截圖匹配動態(tài)定位界面元素（如按鈕、文本框），解決因窗口位置變化導(dǎo)致的腳本失效問題。
?安全可靠：內(nèi)置防誤觸機制（如失效安全點）、操作日志記錄和多線程安全鎖，保障自動化流程的穩(wěn)定性。

二、安裝與環(huán)境配置

?安裝命令：

pip install pyautogui  # 核心庫
pip install Pillow     # 圖像處理依賴（截圖功能必需）

?驗證安裝：

import pyautogui
print(pyautogui.__version__)  # 輸出版本號（如 0.9.54）

?全局安全配置?（防止腳本失控）：

pyautogui.FAILSAFE = True     # 鼠標移至左上角時自動終止程序[2](@ref)
pyautogui.PAUSE = 0.5         # 每次操作后暫停 0.5 秒[2](@ref)

三、核心功能與常用函數(shù)

?1. 鼠標控制

函數(shù)/方法	功能描述	參數(shù)說明
?`pyautogui.moveTo(x, y, duration)`	移動鼠標到絕對坐標 (x, y)	`duration`：移動耗時（秒），設(shè)為 0 則瞬間完成
`pyautogui.moveRel(dx, dy, duration)`	相對當(dāng)前位置偏移 (dx, dy)	常用于動態(tài)調(diào)整位置（如拖拽文件）
`pyautogui.click(x, y, clicks, button)`	點擊操作（左鍵/右鍵/雙擊）	`button`：`'left'`（默認）、`'right'`、`'middle'`
?`pyautogui.dragTo(x, y, duration)`	拖拽到目標位置	需先按住鼠標，常用于文件拖放或繪圖軟件操作
?`pyautogui.scroll(units)`	滾動鼠標滾輪	`units`：正數(shù)向上滾動，負數(shù)向下

示例：自動化文件拖放

pyautogui.moveTo(100, 200, duration=1)  # 移動至文件位置
pyautogui.dragTo(500, 300, duration=2)  # 拖拽至目標文件夾

2. 鍵盤操作

函數(shù)/方法	功能描述	參數(shù)說明
?`pyautogui.write(text, interval)`	模擬鍵盤輸入文本	`interval`：字符輸入間隔時間（秒）
?`pyautogui.press(keys)`	按下并釋放單個按鍵（如 `'enter'`、`'tab'`）	支持 200+ 種按鍵（見 `pyautogui.KEYBOARD_KEYS`）
?`pyautogui.hotkey(*keys)`	組合快捷鍵（如 `'ctrl+c'`）	自動處理按鍵順序（按下 `ctrl` → 按下 `c` → 釋放 `c` → 釋放 `ctrl`）
?`pyautogui.keyDown(key)` / `keyUp(key)`	分別處理按鍵的按下和釋放	用于長按操作（如游戲角色移動）

示例：自動填寫表單

pyautogui.write('張三', interval=0.1)  # 輸入姓名
pyautogui.press('tab')                # 切換至下一輸入框
pyautogui.write('13812345678')        # 輸入手機號
pyautogui.hotkey('ctrl', 's')         # 保存表單[6](@ref)

3. 屏幕與圖像識別

函數(shù)/方法	功能描述	參數(shù)說明
?`pyautogui.screenshot(region)`	截取屏幕區(qū)域圖像	`region`：指定區(qū)域 (x, y, width, height)，默認全屏
?`pyautogui.locateOnScreen(image, confidence)`	在屏幕上匹配目標圖像位置	`confidence`：匹配精度（0~1），推薦 0.8 以上
?`pyautogui.locateCenterOnScreen(image)`	返回匹配圖像的中心坐標	常用于點擊動態(tài)位置的按鈕
?`pyautogui.pixel(x, y)`	獲取指定像素點的 RGB 顏色值	用于判斷界面狀態(tài)（如按鈕是否高亮）

示例：智能點擊動態(tài)按鈕

button_pos = pyautogui.locateOnScreen('submit_button.png', confidence=0.9)
if button_pos:
    x, y = pyautogui.center(button_pos)
    pyautogui.click(x, y)  # 點擊按鈕中心[1,4](@ref)
else:
    raise Exception("未找到提交按鈕")

4. 窗口管理與高級控制

函數(shù)/方法	功能描述	參數(shù)說明
?`pyautogui.getWindowsWithTitle(title)`	獲取指定標題的窗口對象	需配合 `pygetwindow` 庫使用
?`pyautogui.alert(text)`	彈出確認對話框	阻塞程序直至用戶點擊
?`pyautogui.size()`	返回屏幕分辨率 (width, height)	用于計算相對坐標

示例：多窗口協(xié)同操作

# 激活記事本窗口并輸入內(nèi)容
notepad = pyautogui.getWindowsWithTitle('記事本')[0]
notepad.activate()
pyautogui.write('自動錄入文本', interval=0.1)

四、應(yīng)用場景與實戰(zhàn)案例

?自動化辦公
- ?Excel 報表生成：通過熱鍵操作自動打開文件、填充數(shù)據(jù)并保存，耗時從 2 小時縮短至 2 分鐘。
- ?郵件批量發(fā)送：自動填寫收件人、主題和附件，結(jié)合 Outlook 實現(xiàn)無人值守處理。
?數(shù)據(jù)采集與測試
- ?動態(tài)網(wǎng)頁截圖：定時截取網(wǎng)頁數(shù)據(jù)并保存，用于監(jiān)控價格或庫存變化。
- ?UI 自動化測試：驗證軟件界面響應(yīng)，替代人工點擊操作。
?游戲與娛樂
- ?自動連招腳本：在游戲中模擬按鍵序列實現(xiàn)連續(xù)技能釋放。
- ?視頻自動播放：通過圖像識別跳過廣告，自動切換劇集。

?五、注意事項與優(yōu)化技巧

?兼容性優(yōu)化
- 不同操作系統(tǒng)的坐標系統(tǒng)可能差異（如 macOS 的菜單欄高度），需動態(tài)計算偏移量。
- 高分辨率屏幕需調(diào)整圖像識別參數(shù)（如 confidence=0.95）。
?性能提升
- 使用 pyautogui.locateAllOnScreen() 批量識別多個目標，減少截圖次數(shù)。
- 啟用多線程時需加鎖（with pyautogui.lock()），防止操作沖突。
?異常處理
- 捕獲 pyautogui.ImageNotFoundException 以處理圖像識別失敗。
- 記錄操作日志（pyautogui.logScreenshot()）便于調(diào)試。