在PySimpleGUI开发中，除了用鼠标点击按钮触发事件，很多时候我们希望用户直接按键盘上的某个键就能执行对应按钮的逻辑，比如按回车提交、按Esc关闭窗口。这种键盘按键绑定按钮事件的做法，本质是在事件循环里统一处理按钮事件和键盘事件，让两者调用同一段业务代码。
一、PySimpleGUI事件机制基础
PySimpleGUI的所有交互都围绕window.read()展开。每次调用read，程序会阻塞等待用户操作，返回一个元组：第一个元素是发生的事件标识（event），第二个元素是各元素当前的值字典（values）。按钮被点击时，event默认是按钮上显示的文字，或者你在创建时指定的key。
键盘按键在PySimpleGUI中也被视作事件。当你在window创建时通过return_keyboard_events=True开启键盘事件返回，或者给某些元素绑定了按键，read就会把按键信息作为event返回。理解这一点，就能把键盘和按钮看成同一类触发源，在代码里合并处理。
1.1 按钮事件的默认行为
不指定key时，按钮的event就是按钮文本。例如按钮写为sg.Button('提交')，点击后event等于'提交'。如果写了key=('-SUBMIT-',)，点击后event就是该元组。推荐使用key，避免界面文字改动导致事件判断失效。
下面这段示例展示最基础的按钮事件读取方式，暂不绑定键盘：
import PySimpleGUI as sg
layout = [[sg.Button('提交', key='-SUBMIT-')], [sg.Button('退出', key='-EXIT-')]]
window = sg.Window('基础示例', layout)
while True:
event, values = window.read()
if event == sg.WIN_CLOSED or event == '-EXIT-':
break
if event == '-SUBMIT-':
print('按钮被点击，执行提交逻辑')
window.close()
二、开启键盘事件返回
要让窗口捕获按键，必须在创建Window时传入return_keyboard_events=True。开启后，用户按下键盘，read返回的event会是类似'Return'、'Escape'、'a'这样的字符串，代表按键名称。此时原本的按钮事件依旧正常返回，两者共存于同一个循环。
需要注意，当焦点在某个输入框（Input）内时，普通字符按键会被输入框吞掉，不会作为键盘事件返回；但功能键如回车、Esc通常仍会触发。因此绑定字符键做全局快捷键时，要考虑输入框聚焦场景，或者改用sg.read_additional_events？
2.1 最简键盘绑定示例
以下代码把回车键和Esc键绑定到和按钮相同的处理逻辑，实现键盘代替点击：
import PySimpleGUI as sg
layout = [
[sg.Text('按Enter提交，按Esc退出')],
[sg.Button('提交', key='-SUBMIT-')],
[sg.Button('退出', key='-EXIT-')]
]
window = sg.Window('键盘绑定', layout, return_keyboard_events=True)
while True:
event, values = window.read()
# 键盘回车事件字符串为'Return'
if event == sg.WIN_CLOSED or event == '-EXIT-' or event == 'Escape':
break
if event == '-SUBMIT-' or event == 'Return':
print('触发提交：可能来自按钮或回车键')
window.close()
上面代码中，event等于'Return'代表回车键，等于'Escape'代表Esc键。我们把它们直接和按钮key并列判断，就完成了绑定。这种写法清晰，适合快捷键较少的情况。
三、使用bind方法精确绑定
除了全局return_keyboard_events，PySimpleGUI的元素和窗口都提供bind方法，可以把特定按键绑定到自定义事件名。语法为element.bind('<KeyPress-Enter>', '-ENTER-PRESS-')，第一个参数是tkinter按键描述，第二个是自定义事件后缀，最终event会变成该后缀。
这种方式优势在于语义明确，且能针对某个元素绑定，不影响其他组件。下面示例给窗口绑定回车与字母s键，分别映射到不同事件：
import PySimpleGUI as sg
layout = [
[sg.Input(key='-IN-', enable_events=True)],
[sg.Button('保存', key='-SAVE-')],
[sg.Button('关闭', key='-CLOSE-')]
]
window = sg.Window('bind示例', layout)
# 绑定回车键到自定义事件
window.bind('<KeyPress-Return>', '-RETURN-')
# 绑定小写s键
window.bind('<KeyPress-s>', '-KEYS-')
while True:
event, values = window.read()
if event == sg.WIN_CLOSED or event == '-CLOSE-':
break
if event == '-SAVE-' or event == '-RETURN-' or event == '-KEYS-':
print('执行保存，来源：', event)
window.close()
这里即使输入框聚焦，回车也会触发'-RETURN-'（因为bind在窗口级且Tk默认回车不只在输入内生效），而s键在输入中文时可能不会触发，需注意输入法状态。bind适合做复杂快捷键体系。
四、抽取公共处理函数避免重复
当按钮和键盘都触发同一逻辑，直接把判断写长会让循环臃肿。更好做法是把业务写成函数，事件分支里统一调用。这样既清晰又方便维护，以后加新快捷键只需多一个if。
下面演示用函数封装提交与退出动作：
import PySimpleGUI as sg
def do_submit():
print('处理提交数据')
def do_exit():
print('清理并退出')
layout = [[sg.Button('提交', key='-SUBMIT-')], [sg.Button('退出', key='-EXIT-')]]
window = sg.Window('函数封装', layout, return_keyboard_events=True)
while True:
event, values = window.read()
if event == sg.WIN_CLOSED or event == '-EXIT-' or event == 'Escape':
do_exit()
break
if event == '-SUBMIT-' or event == 'Return':
do_submit()
window.close()
这种结构在真实项目中很常见。你可以把快捷键映射写成字典，进一步减少if嵌套，但根据需求简单分支已足够。
五、常见问题与避坑
第一，按键名大小写和系统是有关的，例如Mac上部分键名和Windows不同，调试时建议先print(event)确认。第二，return_keyboard_events开启后，单字符键在输入框聚焦时不返回，要做全局字符快捷键应结合bind。第三，不要给按钮key和键盘事件字符串写成一样，否则无法区分来源，但这通常也无碍。
另一个坑是若在read里用了timeout参数做定时刷新，键盘事件依旧能捕获，但循环会更频繁，注意性能。最后，PySimpleGUI不同版本对bind的支持略有差异，建议锁定版本号部署。
| 方式 | 适用场景 | 优点 | 缺点 |
|---|---|---|---|
| return_keyboard_events | 简单回车/Esc绑定 | 代码少，直观 | 字符键受输入框影响 |
| window.bind | 多快捷键、精确控制 | 语义清晰，可针对元素 | 需写tkinter按键描述 |
| 函数封装 | 所有场景 | 逻辑复用，易维护 | 初期需设计结构 |
通过上述方法，你可以在PySimpleGUI中灵活实现键盘按键绑定按钮事件，让工具操作更高效。实际开发时根据界面复杂度选择组合方案即可。
PySimpleGUI键盘事件按钮绑定修改时间：2026-08-03 01:12:36