HOWTO · Python
在 Python 中模擬鍵盤輸入
瞭解如何在 Python 中模擬鍵盤輸入。
本頁內容
使用 keyboard 套件或 PyAutoGUI,即可從 Python 指令碼輸入文字。前者提供 write() 輸入文字,以及 press_and_release() 傳送按鍵事件。PyAutoGUI 則提供 write()、keyDown()、keyUp() 和 press(),用於輸入文字及傳送個別按鍵事件。請使用 pip install keyboard 或 pip install pyautogui 安裝所選的套件。
兩個程式庫都會將輸入傳送到目前取得焦點的欄位;這兩個範例都不會選取應用程式或欄位。請先準備好輸入目標,並避免將敏感文字輸入到非預期的視窗。模擬輸入的文字會出現在目標應用程式中,不會顯示為終端機輸出。接下來的標準函式庫範例會列印下方操作步驟的計畫,但不會傳送 keyboard 按鍵事件。範例中的程式碼與輸出文字維持原樣;其中若有英文標籤,仍會以英文顯示。
文字字串和按鍵事件是兩種不同的輸入。一般單字與標點符號請使用輸入文字的呼叫;若目標需要收到 Enter 等指定按鍵或修飾鍵組合,則使用按鍵事件呼叫。執行指令碼前,請先準備好目標欄位;調整操作順序時,建議使用無害的測試欄位。範例計畫清楚列出操作順序:先輸入文字,再按 Enter,接著傳送帶有修飾鍵的按鍵事件,最後輸入剩餘字母。請依照要操作的表單或編輯器調整順序,或移除不需要的操作。
執行以下範例:
本節中的程式碼以及顯示的標籤或輸出仍為英文。
text = "Python is an amazing programming language."
actions = [("type", text), ("press", "enter"), ("press", "shift+p"), ("type", "ython")]
for action, value in actions:
print(f"{action}: {value}")
type: Python is an amazing programming language.
press: enter
press: shift+p
type: ython
使用 keyboard 程式庫模擬鍵盤輸入
使用 pip install keyboard 安裝套件。若要輸入一句話、按下 Enter,再按住 Shift 輸入 Python 的第一個字母,套件專用的呼叫順序如下:keyboard.write("Python is an amazing programming language.")、keyboard.press_and_release("enter")、keyboard.press_and_release("shift+p"),以及 keyboard.write("ython")。這些呼叫需要先安裝套件,並且需要有焦點的互動式文字欄位,因此這裡提供的是 API 用法說明,並非已執行的範例。執行前,請先將插入點放在預定位置。目標欄位會先收到該句文字,接著因 Enter 換行,再於下一行輸入 Python。write() 可輸入文字;press_and_release() 則會傳送指定按鍵或組合並隨即放開。在這個範例中,shift+p 會輸入 Python 的大寫首字母。這些呼叫不會選取視窗,也不會移動插入點。按下 Enter 可能會送出表單或啟動控制項;如果目標不應收到 Enter,請省略該呼叫。如果只需要輸入文字,只用 write() 呼叫即可。API 詳細資訊請參閱 keyboard 文件。
使用 PyAutoGUI 模擬鍵盤輸入
使用 pip install pyautogui 安裝 PyAutoGUI。若要輸入句子,接著按住 Shift 依序按下 a、b、c,再輸入小寫的 xyz,套件專用的呼叫順序如下:pyautogui.write("Python is an amazing programming language.")、pyautogui.keyDown("shift")、pyautogui.press("a")、pyautogui.press("b")、pyautogui.press("c")、pyautogui.keyUp("shift"),以及 pyautogui.write("xyz")。這些呼叫需要先安裝套件,並且需要互動式文字輸入目標,因此這裡提供的是 API 用法說明,並非已執行的範例。執行前,請先讓文字欄位取得焦點。目標欄位收到的文字會是 Python is an amazing programming language.ABCxyz:keyDown("shift") 會在三次個別的 press() 呼叫期間持續按住 Shift,因此這些字母會是大寫;keyUp("shift") 則會在輸入 xyz 前放開 Shift。write() 用來輸入指定字串。keyDown() 會持續按住按鍵,直到 keyUp() 將它放開。press() 會對個別按鍵(例如單一字母)傳送按下後放開的事件。若要在多次按鍵期間持續按住修飾鍵,請在那些呼叫前後使用 keyDown() 和 keyUp(),不要把 press() 當成可傳送任意按鍵組合的函式。若只需要輸入文字,只用 write() 即可;需要修飾鍵效果時,才保留按鍵事件操作。更多資訊請參閱 PyAutoGUI 文件。
調整操作順序時,請只在需要修飾鍵的按鍵操作前後使用 keyDown() 和 keyUp()。keyUp() 之後的呼叫不會再受到該修飾鍵影響。若只要輸入一般句子,請完全移除按鍵事件呼叫。這樣可以讓指令碼專注於文字輸入,也更容易找出是哪個操作造成非預期的字元。