Python 3.7全局变量访问异常：为何一个需声明global才能访问？

问题背景 #

在Linux环境的Python 3.7.6中，函数外部声明了两个全局变量px_var_name和xPx_title，但在proc_single_file函数内访问时，px_var_name可正常输出，xPx_title却抛出UnboundLocalError错误，添加global xPx_title声明后问题解决。

原代码 #

px_var_name = "Particles_Px_subset_fract_electron"
xPx_title = "Px vs. x"

def proc_single_file(file_nam):
    print("starting file processing:" + file_nam)
    print(px_var_name)
    print(xPx_title)

proc_single_file('0000.sdf')

错误信息 #

starting file processing:0000.sdf
Particles_Px_subset_fract_electron
Traceback (most recent call last):
  File "phase_space_2d.py", line 227, in <module>
    proc_single_file(listfiles[i])
  File "phase_space_2d.py", line 156, in proc_single_file
    print(xPx_title)
UnboundLocalError: local variable 'xPx_title' referenced before assignment
Object deleted

解决代码 #

px_var_name = "Particles_Px_subset_fract_electron"
xPx_title = "Px vs. x"

def proc_single_file(file_nam):
    global xPx_title
    print("starting file processing:" + file_nam)
    print(px_var_name)
    print(xPx_title)

proc_single_file('0000.sdf')

运行结果 #

starting file processing:0000.sdf
Particles_Px_subset_fract_electron
Px vs. x

原因分析 #

Python的变量作用域遵循核心规则：

• 只要函数内部任意位置存在对某个变量的赋值操作，Python编译函数时会直接将该变量标记为局部变量，哪怕赋值语句在访问语句之后。
• 对于函数内没有赋值操作的变量，Python会先在局部作用域查找，找不到则向上读取全局作用域的变量。

你遇到的问题本质是：实际的proc_single_file函数内部（可能简化代码未体现）存在对xPx_title的赋值操作，导致Python将其认定为局部变量，而你在赋值前就尝试访问，因此抛出UnboundLocalError。而px_var_name在函数内没有任何赋值操作，所以Python直接读取全局作用域的变量值，不会报错。

添加global xPx_title声明后，明确告诉Python该变量属于全局作用域，不会将其视为局部变量，因此可以正常访问全局变量的值。

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