Python函数内通过locals().update()动态设置变量触发NameError问题

这个是Python函数作用域的设计机制导致的，不是bug：

1. 函数的局部变量解析是编译期静态确定的：Python在把函数编译成字节码的时候，就已经扫描完函数里所有直接引用、直接赋值的变量名，给每个局部变量分配了固定的访问槽位，运行时访问局部变量是直接读对应槽位的值，不会动态去查locals()返回的字典。
2. 函数内调用locals()拿到的字典，只是当前局部命名空间的一次性快照，不是真实存储局部变量的本体。你对这个快照字典做update()操作，修改的只是这个临时字典的内容，根本不会同步到函数真正的局部变量槽位里——所以你打印locals()能看到a存在，但直接写print(a)的时候，解释器找a对应的局部槽位发现没绑定值，直接抛出NameError。
3. 为什么globals()操作能生效？因为模块级的全局命名空间本身就是以字典为本体真实存储的，globals()返回的就是这个真实字典的引用，你修改这个字典等价于修改全局变量表，所以访问不会出问题。另外在模块顶层、REPL交互环境里，locals()和globals()指向同一个字典，这时候修改locals()也会生效，只有函数、类内部的locals()是快照副本。

不要尝试通过修改locals()动态注入局部变量，Python官方文档明确标注了不保证这种修改的行为生效，你可以选下面几种稳定方案：

• 方案1：直接从参数字典取值，适合逻辑简单的场景

def run_test(**kwargs):
    # 需要用参数时直接从kwargs读取即可
    print(kwargs["a"])
    print(kwargs["b"])

run_test(a=2, b=3)

• 方案2：用exec加载旧脚本代码，把自定义参数作为执行的局部命名空间传入，最适配复用旧脚本的需求

def run_test(**kwargs):
    # 旧脚本内容可以直接写字符串，也可以从原脚本文件读取
    old_script_content = """
# 这里放原来硬编码参数的旧脚本逻辑
print(a)
print(b)
"""
    # 把传入的kwargs作为exec运行时的本地变量表
    exec(old_script_content, globals(), kwargs)

run_test(a=2, b=3) # 正常输出2、3，不会报错

• 方案3：用命名空间对象包装参数，访问写法更简洁

from types import SimpleNamespace

def run_test(**kwargs):
    params = SimpleNamespace(**kwargs)
    # 访问参数时带对象前缀即可
    print(params.a)
    print(params.b)

run_test(a=2, b=3)

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