如何在VSCode调试器中追踪Python Tkinter GUI程序的变量？

问题场景 #

• 开发Tkinter/Kivy GUI程序时，VSCode调试器仅在启动阶段（GUI窗口未打开）能正常追踪变量、使用watch；当程序进入GUI事件循环（窗口打开）后，左侧变量面板清空，watch项显示“不可用”。
• 线程函数中存在同样问题，尝试设置launch.json的"subProcess":true无效果。
• 代码逻辑正常（如示例中test变量能正常打印），但无法实时查看和修改；程序抛出异常时，变量面板会恢复，窗口冻结。

原因分析 #

1. Tkinter的mainloop()启动后，主线程进入GUI事件循环，VSCode调试器默认配置下会丢失对主线程上下文的持续追踪。
2. 示例代码中calculate函数内的test未声明为全局变量，导致修改的是局部变量，进一步干扰全局变量的追踪。

解决方案 #

1. 修正变量作用域 #

示例代码中calculate函数内的test是局部变量，需添加global声明以关联全局变量，确保调试器能正确识别：

def calculate(*args):
    global test  # 声明使用全局test变量
    try:
        value = float(feet.get())
        test = value
        print(test)
        meters.set(int(0.3048 * value * 10000.0 + 0.5)/10000.0)
    except ValueError:
        pass

2. 调整VSCode调试配置（launch.json） #

更新launch.json配置，添加console参数并保留subProcess，确保调试器持续捕获主线程上下文：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "subProcess": true,
            "justMyCode": false
        }
    ]
}

• console设为integratedTerminal或externalTerminal，避免调试器在事件循环启动后断开连接。
• justMyCode设为false（可选），若需要追踪GUI库内部代码。

3. 手动触发调试暂停 #

若需在GUI运行时实时查看变量，可添加调试触发按钮，调用VSCode的debugpy断点：

def debug_trigger():
    import debugpy
    debugpy.breakpoint()  # 触发调试暂停

# 添加到GUI布局
ttk.Button(mainframe, text="Debug Pause", command=debug_trigger).grid(column=3, row=4, sticky=W, padx=5, pady=5)

点击该按钮即可暂停程序，此时变量面板会恢复显示，可查看和修改所有变量。

4. 使用远程附加调试 #

通过debugpy监听端口，手动附加调试器，这种方式对GUI程序的稳定性更高：

1. 在代码开头添加监听代码：

import debugpy
debugpy.listen(("localhost", 5678))
print("等待调试器附加...")
debugpy.wait_for_client()

2. 在VSCode的launch.json中添加远程附加配置：

{
    "name": "Python: Attach",
    "type": "python",
    "request": "attach",
    "connect": {
        "host": "localhost",
        "port": 5678
    }
}

3. 运行程序后，选择该配置附加调试器，即可全程追踪变量，包括GUI事件循环运行阶段。

内容的提问来源于stack exchange，提问作者Gabriel Schossler