詳解 Python 中 pyautogui 庫 的最全使用方法

 

From：https://www.jb51.net/article/183926.htm

 

在使用Python做腳本的話，有兩個庫可以使用，一個爲PyUserInput庫，另一個爲pyautogui庫。就本人而言，我更喜歡使用pyautogui庫，該庫功能多，使用便利。下面給大家介紹一下pyautogui庫的使用方法。在cmd命令框中輸入pip3 install pyautogui即可安裝該庫！

 

 

常用操作

我們在 pyautogui 庫中常常使用的方法，如下：

import pyautogui

# 調用在執行動作後暫停的秒數，只能在執行一些pyautogui動作後才能使用，建議用time.sleep
pyautogui.PAUSE = 1

# 啓用自動防故障功能，左上角的座標爲（0，0），將鼠標移到屏幕的左上角，來拋出failSafeException異常
pyautogui.FAILSAFE = True

# 判斷(x,y)是否在屏幕上
x, y = 122, 244
pyautogui.onScreen(x, y)  # 結果爲true

width, height = pyautogui.size()  # 屏幕的寬度和高度
print(width, height)

 

 

鼠標操作

我們在 pyautogui 庫對於鼠標的使用方法大體如下：

import pyautogui

currentMouseX, currentMouseY = pyautogui.position()  # 鼠標當前位置
print(currentMouseX, currentMouseY)

# 控制鼠標移動,duration爲持續時間
for i in range(2):
    pyautogui.moveTo(100, 100, duration=0.25)  # 移動到 (100,100)
    pyautogui.moveTo(200, 100, duration=0.25)
    pyautogui.moveTo(200, 200, duration=0.25)
    pyautogui.moveTo(100, 200, duration=0.25)

for i in range(2):
    pyautogui.moveRel(50, 0, duration=0.25)  # 從當前位置右移100像素
    pyautogui.moveRel(0, 50, duration=0.25)  # 向下
    pyautogui.moveRel(-50, 0, duration=0.25)  # 向左
    pyautogui.moveRel(0, -50, duration=0.25)  # 向上

# 按住鼠標左鍵，把鼠標拖拽到(100, 200)位置
pyautogui.dragTo(100, 200, button='left')
# 按住鼠標左鍵，用2秒鐘把鼠標拖拽到(300, 400)位置
pyautogui.dragTo(300, 400, 2, button='left')
# 按住鼠標左鍵，用0.2秒鐘把鼠標向上拖拽
pyautogui.dragRel(0, -60, duration=0.2)

# pyautogui.click(
#     x=moveToX, y=moveToY, clicks=num_of_clicks, 
#     interval=secs_between_clicks, button='left'
# )
# 其中，button屬性可以設置成left，middle和right。
pyautogui.click(10, 20, 2, 0.25, button='left')
pyautogui.click(x=100, y=200, duration=2)  # 先移動到(100, 200)再單擊
pyautogui.click()  # 鼠標當前位置點擊一下
pyautogui.doubleClick()  # 鼠標當前位置左擊兩下
pyautogui.doubleClick(x=100, y=150, button="left")  # 鼠標在（100，150）位置左擊兩下
pyautogui.tripleClick()  # 鼠標當前位置左擊三下

pyautogui.mouseDown()  # 鼠標左鍵按下再鬆開
pyautogui.mouseUp()
pyautogui.mouseDown(button='right')  # 按下鼠標右鍵
pyautogui.mouseUp(button='right', x=100, y=200)  # 移動到(100, 200)位置，然後鬆開鼠標右鍵

# scroll函數控制鼠標滾輪的滾動，amount_to_scroll參數表示滾動的格數。正數則頁面向上滾動，負數則向下滾動
# pyautogui.scroll(clicks=amount_to_scroll, x=moveToX, y=moveToY)
pyautogui.scroll(5, 20, 2)
pyautogui.scroll(10)  # 向上滾動10格
pyautogui.scroll(-10)  # 向下滾動10格
pyautogui.scroll(10, x=100, y=100)  # 移動到(100, 100)位置再向上滾動10格

# 緩動/漸變函數可以改變光標移動過程的速度和方向。通常鼠標是勻速直線運動，這就是線性緩動/漸變函數。
# PyAutoGUI有30種緩動/漸變函數，可以通過pyautogui.ease*?查看。
# 開始很慢，不斷加速
pyautogui.moveTo(100, 100, 2, pyautogui.easeInQuad)
# 開始很快，不斷減速
pyautogui.moveTo(100, 100, 2, pyautogui.easeOutQuad)
# 開始和結束都快，中間比較慢
pyautogui.moveTo(100, 100, 2, pyautogui.easeInOutQuad)
# 一步一徘徊前進
pyautogui.moveTo(100, 100, 2, pyautogui.easeInBounce)
# 徘徊幅度更大，甚至超過起點和終點
pyautogui.moveTo(100, 100, 2, pyautogui.easeInElastic)

對於我們要獲取鼠標在屏幕中的位置，我們可以採用如下代碼：

# 案例獲取鼠標的位置，方便複製我們定位的鼠標座標點到代碼中
import pyautogui
import time


# 獲取鼠標位置
def get_mouse_position():
    time.sleep(5)  # 準備時間
    print('開始獲取鼠標位置')
    try:
        for i in range(10):
            # Get and print the mouse coordinates.
            x, y = pyautogui.position()
            positionStr = '鼠標座標點（X,Y）爲：{},{}'.format(str(x).rjust(4), str(y).rjust(4))
            pix = pyautogui.screenshot().getpixel((x, y))  # 獲取鼠標所在屏幕點的RGB顏色
            positionStr += ' RGB:(' + str(pix[0]).rjust(3) + ',' + str(pix[1]).rjust(3) + ',' + str(pix[2]).rjust(
                3) + ')'
            print(positionStr)
            time.sleep(0.5)  # 停頓時間
    except:
        print('獲取鼠標位置失敗')


if __name__ == "__main__":
    get_mouse_position()

也可以使用pyautogui庫幫助文檔的方法，不過本人認爲使用上面的方法，更加便利。pyautogui庫幫助文檔的獲取鼠標位置的方法如下：

import pyautogui

print('Press Ctrl-C to quit.')
try:
    while True:
        # Get and print the mouse coordinates.
        x, y = pyautogui.position()
        positionStr = 'X:' + str(x).rjust(4) + ' Y:' + str(y).rjust(4)
        pix = pyautogui.screenshot().getpixel((x, y))  # 獲取鼠標所在屏幕點的RGB顏色
        positionStr += ' RGB:(' + str(pix[0]).rjust(3) + ',' + \
                       str(pix[1]).rjust(3) + ',' + str(pix[2]).rjust(3) + ')'
        print(positionStr, end='')  # end='' 替換了默認的換行

        # 連續退格鍵並刷新，刪除之前打印的座標，就像直接更新座標效果
        print('\b' * len(positionStr), end='', flush=True)  
except KeyboardInterrupt:  # 處理 Ctrl-C 按鍵
    print('\nDone.')

 

鍵盤操作

我們在pyautogui庫對於鍵盤的使用方法大體如下：

import pyautogui

pyautogui.typewrite('Hello world!')  # 輸入Hello world!字符串
pyautogui.typewrite('Hello world!', interval=0.25)  # 每次輸入間隔0.25秒，輸入Hello world!

pyautogui.press('enter')  # 按下並鬆開（輕敲）回車鍵
pyautogui.press(['left', 'left', 'left', 'left'])  # 按下並鬆開（輕敲）四下左方向鍵
pyautogui.keyDown('shift')  # 按下`shift`鍵
pyautogui.keyUp('shift')  # 鬆開`shift`鍵

pyautogui.keyDown('shift')
pyautogui.press('4')
pyautogui.keyUp('shift')  # 輸出 $ 符號的按鍵

pyautogui.hotkey('ctrl', 'v')  # 組合按鍵（Ctrl+V），粘貼功能，按下並鬆開'ctrl'和'v'按鍵

# pyautogui.KEYBOARD_KEYS數組中就是press()，keyDown()，keyUp()和hotkey()函數可以輸入的按鍵名稱
pyautogui.KEYBOARD_KEYS = [
    '\t', '\n', '\r', ' ', '!', '"', '#', '$', '%', '&', "'", '(', ')', '*', '+', ',', '-', '.',
    '/', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', '<', '=', '>', '?', '@',
    '[', '\\', ']', '^', '_', '`', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l',
    'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', '{', '|', '}', '~',
    'accept', 'add', 'alt', 'altleft', 'altright', 'apps', 'backspace', 'browserback',
    'browserfavorites', 'browserforward', 'browserhome', 'browserrefresh', 'browsersearch',
    'browserstop', 'capslock', 'clear', 'convert', 'ctrl', 'ctrlleft', 'ctrlright', 'decimal',
    'del', 'delete', 'divide', 'down', 'end', 'enter', 'esc', 'escape', 'execute', 'f1', 'f10',
    'f11', 'f12', 'f13', 'f14', 'f15', 'f16', 'f17', 'f18', 'f19', 'f2', 'f20', 'f21', 'f22',
    'f23', 'f24', 'f3', 'f4', 'f5', 'f6', 'f7', 'f8', 'f9', 'final', 'fn', 'hanguel', 'hangul',
    'hanja', 'help', 'home', 'insert', 'junja', 'kana', 'kanji', 'launchapp1', 'launchapp2',
    'launchmail', 'launchmediaselect', 'left', 'modechange', 'multiply', 'nexttrack',
    'nonconvert', 'num0', 'num1', 'num2', 'num3', 'num4', 'num5', 'num6', 'num7', 'num8', 'num9',
    'numlock', 'pagedown', 'pageup', 'pause', 'pgdn', 'pgup', 'playpause', 'prevtrack', 'print',
    'printscreen', 'prntscrn', 'prtsc', 'prtscr', 'return', 'right', 'scrolllock', 'select',
    'separator', 'shift', 'shiftleft', 'shiftright', 'sleep', 'space', 'stop', 'subtract', 'tab',
    'up', 'volumedown', 'volumemute', 'volumeup', 'win', 'winleft', 'winright', 'yen', 'command',
    'option', 'optionleft', 'optionright'
]

 

彈窗操作

我們在 pyautogui 庫對於彈出窗口的使用方法大體如下：

import pyautogui

# 顯示一個簡單的帶文字和OK按鈕的消息彈窗。用戶點擊後返回button的文字。
pyautogui.alert(text='', title='', button='OK')
b = pyautogui.alert(text='要開始程序麼？', title='請求框', button='OK')
print(b)  # 輸出結果爲OK

# 顯示一個簡單的帶文字、OK和Cancel按鈕的消息彈窗，用戶點擊後返回被點擊button的文字，支持自定義數字、文字的列表。
pyautogui.confirm(text='', title='', buttons=['OK', 'Cancel'])  # OK和Cancel按鈕的消息彈窗
pyautogui.confirm(text='', title='', buttons=range(10))  # 10個按鍵0-9的消息彈窗
a = pyautogui.confirm(text='', title='', buttons=range(10))
print(a)  # 輸出結果爲你選的數字

# 可以輸入的消息彈窗，帶OK和Cancel按鈕。用戶點擊OK按鈕返回輸入的文字，點擊Cancel按鈕返回None。
pyautogui.prompt(text='', title='', default='')

# 樣式同prompt()，用於輸入密碼，消息用*表示。帶OK和Cancel按鈕。
# 用戶點擊OK按鈕返回輸入的文字，點擊Cancel按鈕返回None。
pyautogui.password(text='', title='', default='', mask='*')

 

圖像操作

我們在pyautogui庫對於圖像的使用方法大體如下：

import pyautogui

# 截全屏並設置保存圖片的位置和名稱
pyautogui.screenshot(r'C:\Users\ZDH\Desktop\PY\my_screenshot.png')  

# 截全屏並設置保存圖片的位置和名稱
im = pyautogui.screenshot(r'C:\Users\ZDH\Desktop\PY\my_screenshot.png')  
print(im)  # 打印圖片的屬性

# 不截全屏，截取區域圖片。截取區域region參數爲：左上角XY座標值、寬度和高度
pyautogui.screenshot(
    r'C:\Users\ZDH\Desktop\PY\region_screenshot.png', 
    region=(0, 0, 300, 400)
)

pix = pyautogui.screenshot().getpixel((220, 200))  # 獲取座標(220,200)所在屏幕點的RGB顏色
positionStr = ' RGB:(' + str(pix[0]).rjust(3) + ',' + \
              str(pix[1]).rjust(3) + ',' + str(pix[2]).rjust(3) + ')'
print(positionStr)  # 打印結果爲RGB:( 60, 63, 65)
pix = pyautogui.pixel(220, 200)  # 獲取座標(220,200)所在屏幕點的RGB顏色與上面三行代碼作用一樣
positionStr = ' RGB:(' + str(pix[0]).rjust(3) + ',' + \
              str(pix[1]).rjust(3) + ',' + str(pix[2]).rjust(3) + ')'
print(positionStr)  # 打印結果爲RGB:( 60, 63, 65)

# 如果你只是要檢驗一下指定位置的像素值，可以用pixelMatchesColor(x,y,RGB)函數，把X、Y和RGB元組值穿入即可
# 如果所在屏幕中(x,y)點的實際RGB三色與函數中的RGB一樣就會返回True，否則返回False
# tolerance參數可以指定紅、綠、藍3種顏色誤差範圍
pyautogui.pixelMatchesColor(100, 200, (255, 255, 255))
pyautogui.pixelMatchesColor(100, 200, (255, 255, 245), tolerance=10)

# 獲得文件圖片在現在的屏幕上面的座標，返回的是一個元組(top, left, width, height)
# 如果截圖沒找到，pyautogui.locateOnScreen()函數返回None
a = pyautogui.locateOnScreen(r'C:\Users\ZDH\Desktop\PY\region_screenshot.png')
print(a)  # 打印結果爲Box(left=0, top=0, width=300, height=400)
x, y = pyautogui.center(a)  # 獲得文件圖片在現在的屏幕上面的中心座標
print(x, y)  # 打印結果爲150 200

# 這步與上面的四行代碼作用一樣
x, y = pyautogui.locateCenterOnScreen(r'C:\Users\ZDH\Desktop\PY\region_screenshot.png')  
print(x, y)  # 打印結果爲150 200

# 匹配屏幕所有與目標圖片的對象，可以用for循環和list()輸出
pyautogui.locateAllOnScreen(r'C:\Users\ZDH\Desktop\PY\region_screenshot.png')
for pos in pyautogui.locateAllOnScreen(r'C:\Users\ZDH\Desktop\PY\region_screenshot.png'):
    print(pos)
# 打印結果爲Box(left=0, top=0, width=300, height=400)
a = list(pyautogui.locateAllOnScreen(r'C:\Users\ZDH\Desktop\PY\region_screenshot.png'))
print(a)  # 打印結果爲[Box(left=0, top=0, width=300, height=400)]

 

參考資料

PyAutoGUI幫助文檔：
https://blog.csdn.net/qq_34053552/article/details/79776671
pyautogui圖形自動化，擊敗重複性辦公任務：
https://blog.csdn.net/qq_43017750/article/details/90575240