PySimpleGUI中预定义事件键被追加数字变更的原因咨询

这种情况的核心原因是PySimpleGUI要求所有元素的Key必须全局唯一，当检测到重复的Key时，它会自动给后续出现的重复Key追加数字后缀，以此避免冲突。具体触发场景通常有以下几种：

常见触发原因 #

• 主窗口与子窗口Key重复：如果主窗口和子窗口的布局中使用了相同的Key（比如都用key='confirm'的按钮），第二个出现的元素Key会被自动加上数字（比如confirm1）。
• 重复加载同一布局：如果你的代码中多次加载同一个布局模板（比如循环创建多个子窗口时复用同一布局），每次加载时相同Key的元素都会被追加数字，因为PySimpleGUI会全局追踪所有已创建元素的Key。
• 动态元素重复添加：通过代码动态向窗口中添加元素时，若重复使用了已存在的Key，新元素的Key会被自动重命名。

解决办法 #

• 全局唯一命名Key：给不同窗口或模块的元素Key加前缀区分，比如主窗口用main_开头，子窗口用sub_开头（如main_confirm、sub_confirm），从根源避免重复。
• 子窗口独立初始化：创建子窗口时，单独定义布局并初始化sg.Window，不要复用主窗口的元素或布局对象，确保子窗口的元素Key和主窗口完全隔离。
• 动态生成唯一Key：如果需要批量创建元素，通过索引或标识符生成唯一Key，比如循环中用f'btn_{index}'的格式来保证每个Key唯一。

示例对比 #

错误写法（导致Key追加数字）

# 主窗口布局
main_layout = [[sg.Button('打开子窗口', key='open_win')]]
# 子窗口布局重复使用同一Key
sub_layout = [[sg.Button('关闭窗口', key='open_win')]]

main_win = sg.Window('主窗口', main_layout)
sub_win = sg.Window('子窗口', sub_layout)

此时子窗口的按钮Key会被自动改为open_win1。

正确写法（Key唯一）

main_layout = [[sg.Button('打开子窗口', key='main_open_win')]]
sub_layout = [[sg.Button('关闭窗口', key='sub_close_win')]]

main_win = sg.Window('主窗口', main_layout)
sub_win = sg.Window('子窗口', sub_layout)

这种情况下所有Key都是唯一的，不会被自动修改。

内容的提问来源于stack exchange，提问作者Bar Kadosh