PyAutoGUI 키 이름 목록 enter tab ctrl win shift f1 완벽 가이드

PyAutoGUI 키 이름 목록 enter tab ctrl win shift f1 완벽 가이드

⌨️ 자동화를 더 정확하게, PyAutoGUI 키 이름 한눈에 정리했습니다

파이썬으로 키보드 작업을 자동화할 때 가장 먼저 막히는 지점은 키 이름을 정확히 기억하는 일입니다.
특히 enter, tab, ctrl, win, shift, f1처럼 자주 쓰는 키부터 방향키, 기능키, 숫자패드까지 표기 방식이 제각각이라 헷갈리기 쉽죠.
PyAutoGUI는 미리 정의된 키 이름을 정확히 써야만 press, keyDown, keyUp, hotkey 같은 함수가 제대로 동작합니다.
그래서 이 글에서는 실무에서 가장 많이 묻는 표기 혼동을 정리하고, 키 그룹별로 깔끔하게 찾을 수 있도록 구성했습니다.
몇 줄의 코드로 테스트할 수 있는 예시도 함께 안내하여 초보자라도 실수 없이 자동화를 시작하도록 돕습니다.

본문에서는 PyAutoGUI에서 인식하는 핵심 키 이름을 그룹별로 정리하고, 좌우 구분이 필요한 수정키, 함수키(F1~F24), 편집키와 네비게이션 키, 숫자패드와 멀티미디어 키 등 실제 자동화 시나리오에서 자주 마주치는 구성을 중심으로 설명합니다.
또한 키 조합 단축키를 안정적으로 보내는 기본 패턴과 입력 충돌을 줄이는 요령을 간단한 코드와 함께 소개합니다.
필수 키워드인 enter, tab, ctrl, win, shift, f1을 포함해 헷갈리기 쉬운 표기도 빠짐없이 짚어 드립니다.
한 페이지 북마크만으로 반복 확인이 가능한 레퍼런스를 마련하고자 했으니, 프로젝트 중간중간 바로 참조하며 활용해 보세요.

🔗 PyAutoGUI 키 이름 전체 개요

PyAutoGUI에서 키보드 입력을 다룰 때는 미리 정의된 키 이름을 정확히 써야 합니다.
스펠링 한 글자라도 다르면 입력이 전달되지 않으므로, 표기 규칙을 먼저 이해하는 것이 좋습니다.
기본 원칙은 모두 소문자 사용, 공백 대신 하이픈 또는 합성어 그대로 표기, 기능키는 약속된 영문 키워드를 사용한다는 점입니다.
예를 들어 enter, tab, ctrl, shift, win(Windows), command(macOS), f1처럼 명확한 이름이 정해져 있습니다.
또한 키를 길게 누르거나 조합을 보낼 때는 keyDown/keyUp과 hotkey를 적절히 사용합니다.

현재 환경에서 유효한 전체 키 이름 목록은 내부 상수인 pyautogui.KEYBOARD_KEYS에서 확인할 수 있습니다.
이 컬렉션을 출력해 두면 프로젝트마다 일관된 기준을 세울 수 있고, 운영체제에 따른 차이도 손쉽게 점검할 수 있습니다.
또한 동일한 동작이라도 앱마다 단축키가 다르므로, enter와 tab처럼 이동·확정 성격의 키는 지연 시간(pause)을 조금 넣어 충돌을 줄이는 습관이 안정적입니다.

import pyautogui

# 전체 키 이름 목록 확인
print(len(pyautogui.KEYBOARD_KEYS))
print(sorted(pyautogui.KEYBOARD_KEYS)[:50])  # 일부만 미리보기

# 가장 자주 쓰는 키 예시
pyautogui.press("enter")
pyautogui.press(["tab", "tab", "space"])
pyautogui.hotkey("ctrl", "s")        # 저장
pyautogui.hotkey("ctrl", "shift", "n")  # 새 폴더(Windows 파일 탐색기)
pyautogui.hotkey("win", "r")         # 실행 창(Windows)

• 🧩KEYBOARD_KEYS를 출력해 프로젝트 기준 목록을 확인
• ⌨️자주 쓰는 enter, tab, ctrl, shift, win, f1를 우선 테스트
• ⏱️앱 반응이 느리면 pyautogui.PAUSE 또는 단계별 time.sleep으로 여유를 둠
• 🧪조합키는 hotkey를 우선 활용하고, 특수 케이스만 keyDown/keyUp으로 세밀 제어

🛠️ 수정키와 조합키 사용법 ctrl shift alt win cmd

자동화 과정에서 가장 많이 쓰이는 키는 바로 수정키(Modifier Keys)입니다.
대표적으로 ctrl, shift, alt, win(Windows), command(macOS) 등이 있습니다.
이 키들은 단독으로 입력하기보다는 다른 키와 함께 눌러 단축키 기능을 수행합니다.
PyAutoGUI에서는 이들을 hotkey() 함수로 손쉽게 조합할 수 있고, 필요한 경우 keyDown()과 keyUp()을 이용해 수동 제어도 가능합니다.

예를 들어 ctrl + c는 복사, ctrl + v는 붙여넣기, ctrl + s는 저장 기능을 수행합니다.
또한 Windows 환경에서는 win + r로 실행 창을 열 수 있으며, macOS에서는 command + space로 Spotlight 검색을 실행할 수 있습니다.
이처럼 운영체제마다 다르게 동작하는 부분이 있으므로, 키 이름뿐만 아니라 플랫폼 차이도 고려해야 합니다.

import pyautogui
import time

# Ctrl + C (복사)
pyautogui.hotkey("ctrl", "c")

# Ctrl + V (붙여넣기)
pyautogui.hotkey("ctrl", "v")

# Windows에서 실행창 열기
pyautogui.hotkey("win", "r")

# 수동 조합 제어 (Shift + A → 대문자 A 입력)
pyautogui.keyDown("shift")
pyautogui.press("a")
pyautogui.keyUp("shift")

💬 조합키 입력 시에는 입력 순서가 중요합니다. keyDown()으로 수정키를 먼저 누르고, 대상 키를 입력한 뒤 keyUp()으로 해제하는 방식이 기본 원칙입니다.

⚙️ 함수키와 특수키 f1 esc enter tab space

프로그램을 자동화할 때는 함수키(Function Keys)와 특수키 입력도 자주 필요합니다.
특히 F1부터 F24까지는 애플리케이션 단축키로 광범위하게 사용되고, esc는 취소, enter는 확인, tab은 이동, space는 선택을 담당하는 등 핵심 동작에 해당합니다.
PyAutoGUI에서는 이들을 소문자로 그대로 입력하면 인식합니다.

또한 특수키 중 backspace, delete, capslock, numlock처럼 토글 성격의 키도 지원됩니다.
이 키들은 상태를 전환하는 성격을 가지므로 반복 실행 시 주의해야 합니다.
실무에서는 폼 입력 자동화, 파일 탐색기 단축키, 웹 브라우저 네비게이션 등 다양한 상황에서 활용됩니다.

import pyautogui

# 함수키 예시
pyautogui.press("f1")       # 도움말 열기
pyautogui.press("f5")       # 새로고침
pyautogui.press("f11")      # 전체화면

# 특수키 예시
pyautogui.press("esc")      # 취소
pyautogui.press("enter")    # 확인
pyautogui.press("tab")      # 다음 입력 필드
pyautogui.press("space")    # 체크박스 선택/해제

🧭 방향키 편집키 네비게이션키 이름 정리

문서 작성이나 UI 자동화에서는 커서 이동과 편집 관련 키가 자주 활용됩니다.
PyAutoGUI는 이를 모두 지원하며, 이름 역시 명확하게 정의되어 있습니다.
방향키는 up, down, left, right로 입력하며, 페이지 이동은 pageup, pagedown을 사용합니다.
또한 home과 end는 줄의 시작과 끝으로 이동하는 데 유용합니다.

편집 작업에서는 insert, delete, backspace가 자주 쓰이며, 이 키들을 조합해 입력 자동화 시 다양한 상황을 처리할 수 있습니다.
특히 폼 입력 자동화 시 tab으로 이동하면서 delete로 기존 텍스트를 지우고 새로 입력하는 패턴이 자주 등장합니다.

import pyautogui

# 방향키 이동
pyautogui.press("up")
pyautogui.press("down")
pyautogui.press("left")
pyautogui.press("right")

# 네비게이션 키
pyautogui.press("home")      # 문장 시작
pyautogui.press("end")       # 문장 끝
pyautogui.press("pageup")    # 위로 스크롤
pyautogui.press("pagedown")  # 아래로 스크롤

# 편집 키
pyautogui.press("backspace")
pyautogui.press("delete")
pyautogui.press("insert")

🔌 숫자패드 멀티미디어 로케일 키 주의사항

PyAutoGUI는 기본 키보드 레이아웃에 포함된 키 외에도 숫자패드(Numpad), 멀티미디어 키, 로케일 특수 키를 지원합니다.
하지만 이들 키는 운영체제와 하드웨어마다 차이가 크기 때문에 사용 시 주의가 필요합니다.
특히 숫자패드는 일반 숫자 키와 구분해야 하며, 일부 멀티미디어 키는 PyAutoGUI 기본 API에서 직접 지원되지 않고 OS 레벨에서만 작동할 수 있습니다.

예를 들어 numpad0 ~ numpad9, numpadadd, numpadsub, numpadenter 같은 키 이름이 있고, 멀티미디어 키는 volumeup, volumedown, playpause 등으로 표현됩니다.
한국어 입력기와 같은 로케일 키는 hangul, hanja 형태로 지원됩니다.

import pyautogui

# 숫자패드 입력
pyautogui.press("numpad0")
pyautogui.press("numpadenter")
pyautogui.press("numpadadd")

# 멀티미디어 키 (운영체제별 지원 여부 다름)
pyautogui.press("volumeup")
pyautogui.press("volumedown")
pyautogui.press("playpause")

# 한국어 로케일 키
pyautogui.press("hangul")   # 한/영 전환
pyautogui.press("hanja")    # 한자 변환

❓ 자주 묻는 질문 FAQ

📌 PyAutoGUI 키 이름 정리와 활용 가이드

PyAutoGUI의 키 이름은 자동화 작업의 정확성을 좌우하는 핵심 요소입니다.
모든 키 이름은 소문자이며, enter, tab, ctrl, win, shift, f1 같은 기본 키부터 함수키, 방향키, 편집키, 숫자패드, 멀티미디어 키, 로케일 키까지 폭넓게 지원합니다.
실제 활용에서는 hotkey()를 통한 단축키 조합, press()의 반복 입력, keyDown()/keyUp()을 통한 세밀 제어가 큰 역할을 합니다.

이번 가이드를 통해 키 이름 체계를 명확히 이해하면 자동화 스크립트를 훨씬 안정적으로 작성할 수 있습니다.
운영체제와 애플리케이션에 따라 키 동작이 달라질 수 있으므로, 프로젝트 시작 전에 pyautogui.KEYBOARD_KEYS를 출력해 확인하는 습관을 들이면 오류를 크게 줄일 수 있습니다.
정리된 키 이름 목록은 반복 참조가 가능하므로, 실무에서 빠른 작업 전환과 유지보수에도 큰 도움이 됩니다.

🏷️ 관련 태그 : pyautogui, 파이썬자동화, 키보드입력, 단축키자동화, 파이썬매크로, 프로그래밍팁, 파이썬기초, 함수키, 파이썬단축키, 파이썬GUI