重装Python 3.13.7后使用locals()出现KeyError问题求助

这不是你重装Python时遗漏了什么，是Python 3.11及之后版本对函数局部变量的处理做了优化：通过locals()修改局部变量的行为被严格限制了——手动给locals()返回的字典添加键值对，不会同步到实际的局部变量环境，后续调用locals()也不会包含你刚添加的内容，所以才会抛出KeyError。之前Python 3.10及更早版本允许这种操作，但这本来就属于未定义行为，官方从未推荐过这么用。

解决方法 #

方法一：用自定义字典存储动态变量（推荐） #

自己创建字典管理动态变量，既避开locals()的问题，还能解决Tkinter PhotoImage的垃圾回收问题：

def add_image():
    dynamic_vars = {}
    variable = 'figura10'
    dynamic_vars[variable] = PhotoImage(file='../Figuras_Ayuda/Fig10.png')
    my_text.image_create(END, image=dynamic_vars[variable])

方法二：使用全局变量（不推荐） #

如果一定要沿用动态命名变量的方式，可以改用globals()，但全局变量容易引发命名冲突，维护成本高：

def add_image():
    variable = 'figura10'
    globals()[variable] = PhotoImage(file='../Figuras_Ayuda/Fig10.png')
    my_text.image_create(END, image=globals()[variable])

额外提醒：Tkinter的PhotoImage对象如果仅存在局部变量中，会被Python垃圾回收机制回收，导致图片无法显示。上面两种方法通过字典或全局变量持有对象引用，刚好能避免这个问题。

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