sg.如何使用PySimpleGUI调试器窗口

PySimpleGUI调试器窗口是开发者在代码运行时实时监控变量、执行交互式命令的强大工具，其使用方法及核心功能如下：

一、核心使用步骤

1. 启用异步窗口模式
   调试器依赖异步窗口（非阻塞读取）工作，需在read()方法中设置timeout参数（单位：毫秒）。例如：

   import PySimpleGUI as sg
   window = sg.Window('Debugger Demo', [[sg.Text('Debugger'), sg.Input(), sg.Button('Push Me')]])
   while True:event, values = window.read(timeout=500)  # 每500ms检查一次事件if event == sg.TIMEOUT_KEY:continue  # 忽略超时事件if event == sg.WIN_CLOSED:breakprint(event, values)
   window.close()
   

   若未设置timeout，调试器可能无法正常获取程序状态。

2. 启动调试器窗口
   在代码中任意位置调用show_debugger_window()函数，并指定窗口位置（可选）：

   sg.show_debugger_window(location=(10, 10))  # 窗口出现在屏幕(10,10)坐标处
   

二、调试器窗口功能

1. 变量监控（Variables Tab）

   • 自动观察列表：显示当前作用域内的局部变量，可勾选需跟踪的变量。
   • 实时更新：变量值随程序执行动态刷新，适合排查间歇性错误。

2. 交互式控制台（REPL Tab）

   • 提供Python交互式环境，可直接执行命令（如修改变量、调用函数）。
   • 示例：在REPL中输入values['input'] = 'new_value'可动态修改输入框内容。

3. 弹出式调试窗口（Popout Window）

   • 快捷键触发：按键盘BREAK键（部分键盘标记为Pause）打开。
   • 非交互式快照：显示当前变量状态，但无法修改值。
   • 手动调用：通过show_debugger_popout_window(location=(x,y))指定位置打开。

三、高级调试技巧

1. 调试输出重定向
   使用sg.Print()替代print()，输出内容会显示在调试窗口中：

   sg.Print('Debug message')  # 输出到调试窗口
   # 或重定向标准输出
   print = sg.Print
   print('All prints go to debugger')
   

2. 动态修改代码逻辑
   在REPL中直接修改变量或调用函数，无需重启程序。例如：

   # 假设程序中有全局变量 `counter`
   counter = 0
   # 在REPL中输入：
   counter = 10  # 立即生效
   

3. 调试窗口位置控制

   • 主调试器窗口默认出现在屏幕右上角，可通过location参数调整。
   • 弹出窗口位置灵活，适合多屏环境。

四、常见问题解决

1. 调试器窗口不更新

   • 检查read()是否设置了timeout，且值合理（如200-500ms）。
   • 避免阻塞操作（如长时间循环），确保事件循环能定期触发。

2. 变量未显示

   • 确保变量在调用show_debugger_window()时已定义。
   • 弹出窗口仅显示调用时的变量快照，后续新增变量不会自动加入。

3. 性能影响

   • 调试器通过窃取异步调用时间片工作，对主程序性能影响极小。
   • 若发现卡顿，可增大timeout值（如从200ms调至1000ms）。

五、代码示例整合

import PySimpleGUI as sg# 设置主题（可选）
sg.theme('LightGray1')# 布局
layout = [[sg.Text('Enter text:'), sg.Input(key='-INPUT-')],[sg.Button('Submit'), sg.Button('Exit')],[sg.Text('Output:', key='-OUTPUT-')]
]# 创建窗口
window = sg.Window('Debugger Demo', layout)# 启动调试器（位置可选）
sg.show_debugger_window(location=(500, 100))# 事件循环
while True:event, values = window.read(timeout=200)  # 异步读取if event == sg.WIN_CLOSED or event == 'Exit':breakif event == 'Submit':window['-OUTPUT-'].update(f'You entered: {values["-INPUT-"]}')sg.Print(f'Submitted value: {values["-INPUT-"]}')  # 输出到调试窗口window.close()

操作流程：

1. 运行程序，调试窗口自动弹出。
2. 在主窗口输入文本并点击“Submit”，观察调试窗口中的输出。
3. 在调试器的REPL中输入values['-INPUT-']查看输入值，或直接修改变量。
4. 按BREAK键打开弹出窗口，快速检查当前变量状态。