PyCharm中Debug与Run模式行为差异原因及解决办法

问题重现 #

代码如下：

import ctypes
import inspect


def fun():
    c = 3
    inspect.currentframe().f_locals['c'] = 4
    ctypes.pythonapi.PyFrame_LocalsToFast(ctypes.py_object(inspect.currentframe()), ctypes.c_int(0))
    print(c)


fun()

• Run模式：运行后输出 4
• Debug模式：在print(c)处设置断点，通过调试控制台调用print(c)，输出 3

原因分析 #

这是PyCharm的PyDev调试器的机制导致的：

1. Python的局部变量实际存储在栈帧的fast locals数组中，f_locals是动态生成的字典，修改它后需要PyFrame_LocalsToFast同步到fast locals，正常运行时这个同步是生效的，所以代码里的print(c)能拿到最新值。
2. 调试模式下，PyDev调试器会为栈帧维护一份独立的变量快照副本，用于在调试面板展示变量、响应控制台的变量访问请求。当你通过底层API修改帧的局部变量时，调试器的快照不会自动同步更新，因此控制台直接调用print(c)时，读取的是调试器保存的旧快照值，而非实际栈帧中的最新值。

注意：此时继续运行代码，print(c)的输出仍然是4，说明实际变量值已经修改，只是调试控制台的视图没同步。

解决办法 #

方案1：避免使用底层API修改局部变量（推荐） #

直接通过Python原生的赋值方式修改变量，这种方式在调试和运行模式下行为完全一致：

def fun():
    c = 3
    c = 4
    print(c)

方案2：强制刷新调试器的变量视图（仅当必须使用底层API时） #

• 在控制台先执行inspect.currentframe().f_locals，触发调试器重新读取栈帧的局部变量，之后再调用print(c)就能得到最新值。
• 或者在PyCharm的调试「Variables」面板中，右键点击目标变量，选择「Refresh」手动刷新变量视图，再在控制台访问。

内容的提问来源于stack exchange，提问作者Kazarin V.