如何在Python内部函数中无错误使用局部、non-local及全局变量

Python的变量作用域规则不允许同一个标识符同时被标记为局部、nonlocal或全局变量。当你在函数内先使用某个变量作为局部变量，再用nonlocal或global声明它时，解释器会报错——因为编译阶段就已经确定了该变量的作用域类型，不能中途改变。同时，nonlocal和global也不能同时声明同一个变量。

以下是两种可行的解决方案：

方案1：给不同作用域的变量使用不同名称（推荐） #

这是最清晰、最不易出错的方式，直接通过命名区分不同作用域的变量，彻底避免冲突：

# 全局变量
global_x = 0

def outer():
    # outer函数的局部变量（inner的nonlocal变量）
    outer_x = 5
    
    def inner():
        # inner的局部变量
        local_x = 10
        local_x += 1
        print(f"局部变量: {local_x}")
        
        # 引用outer层的变量（nonlocal）
        nonlocal outer_x
        outer_x += 1
        print(f"nonlocal变量（outer层）: {outer_x}")
        
        # 引用全局变量
        global global_x
        global_x += 1
        print(f"全局变量: {global_x}")
    
    inner()

outer()

运行结果：

局部变量: 11
nonlocal变量（outer层）: 6
全局变量: 1

方案2：通过作用域访问器绕过命名冲突（不推荐，仅作演示） #

如果一定要保留同一个变量名，可以通过Python的作用域内置方法或可变容器来间接访问不同作用域的变量：

方法A：用globals()访问全局变量，用可变容器存储外层变量 #

x = 0  # 全局变量

def outer():
    # 用列表存储外层变量（可变对象，无需nonlocal即可修改）
    outer_x = [5]
    
    def inner():
        # inner的局部变量x
        x = 10
        x += 1
        print(f"局部变量x: {x}")
        
        # 访问并修改outer层的x
        outer_x[0] += 1
        print(f"nonlocal变量x（outer层）: {outer_x[0]}")
        
        # 访问并修改全局变量x
        globals()['x'] += 1
        print(f"全局变量x: {globals()['x']}")
    
    inner()

outer()

方法B：通过外层函数的属性访问nonlocal变量 #

x = 0  # 全局变量

def outer():
    outer.x = 5  # 将变量绑定为outer函数的属性
    
    def inner():
        # inner的局部变量x
        x = 10
        x += 1
        print(f"局部变量x: {x}")
        
        # 访问并修改outer层的x
        outer.x += 1
        print(f"nonlocal变量x（outer层）: {outer.x}")
        
        # 访问并修改全局变量x
        globals()['x'] += 1
        print(f"全局变量x: {globals()['x']}")
    
    inner()

outer()

关键规则回顾 #

• 函数内的global/nonlocal声明会作用于整个函数，变量不能在声明前被当作局部变量使用。
• 同一个变量名不能同时被声明为global和nonlocal。
• 优先使用不同命名区分作用域变量，这能让代码更易读、更易维护。

内容的提问来源于stack exchange，提问作者Super Kai - Kazuya Ito