Python函数局部变量外部访问触发NameError原因解析

先给出待分析的原始代码：

def a_function(a_parameter):
    a_variable = 15
    return a_parameter
a_function(10)
print(a_variable)

运行上述代码会在print(a_variable)行抛出NameError: name 'a_variable' is not defined异常，错误本质完全遵循Python的作用域与命名空间规则，绝非表层的“变量没声明”问题，拆解如下：

• 局部作用域的隔离规则：Python中函数是一级作用域边界，所有在函数缩进内部赋值生成的变量（含函数形参、函数体内直接赋值的变量），默认都归属于当前函数的局部命名空间，和函数外的全局命名空间完全隔离、互不干扰。代码中a_variable = 15的赋值语句位于a_function的函数体缩进范围内，从赋值完成的那一刻起，它就只存在于a_function的局部命名空间里，全局环境根本感知不到这个名字的存在。
• 局部变量的生命周期规则：函数内部的局部变量，存活周期和函数调用过程完全绑定。执行a_function(10)时，Python会临时开辟一块独立的内存空间存放本次函数调用的局部命名空间，依次完成形参a_parameter绑定实参10、局部变量a_variable绑定整数15的操作；等函数执行到return语句退出的瞬间，这块临时命名空间就会被回收，里面所有的变量名和值的绑定关系会被直接销毁，不会残留到全局环境中。
• 名字查找的顺序规则：执行最外层的print(a_variable)时，Python会按照「当前作用域→外层嵌套作用域→全局作用域→内置作用域」的顺序查找a_variable这个名字的绑定关系。当前执行位置在全局层，全局作用域从来没有定义过这个变量，之前函数调用时生成的同名局部变量早已随着函数退出被回收，完全不在当前可查找的作用域链范围内，自然会触发名称错误。

常见误区澄清：不少初学者会误以为“调用过函数之后，函数里创建的变量就能在外面直接用”，这是对作用域规则的典型误解。如果需要在函数外部使用函数内部生成的值，要么通过return语句把值传递到外部接收，要么显式声明变量为全局变量（后者不推荐，易造成命名空间污染），参考可正常运行的修改版本：

def a_function(a_parameter):
    a_variable = 15
    return a_parameter, a_variable
_, outer_var = a_function(10)
print(outer_var)  # 正常输出15

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