Python 为什么闭包中修改外部变量要用 nonlocal？-Python教程-PHP中文网

Python闭包中修改外层变量需用nonlocal声明，否则赋值会触发UnboundLocalError；因赋值使变量默认为局部变量，而读取时按LEGB规则查找，nonlocal显式声明可变闭包以保障代码明确性。

python 为什么闭包中修改外部变量要用 nonlocal？

因为 Python 默认把函数内赋值的变量当作局部变量，即使同名变量在外部作用域已存在，不加 nonlocal 就无法在闭包中修改外层函数的变量。

作用域规则决定了赋值行为

Python 遵循 LEGB 规则（Local → Enclosing → Global → Built-in），但只读访问和写入访问的处理方式不同：

读取变量时，会按 LEGB 顺序向上查找
一旦在函数体内对某个变量执行了赋值（如 x = x + 1），Python 就默认这个变量是当前函数的局部变量
此时若该变量在外部作用域存在，但未声明为 nonlocal 或 global，就会报 UnboundLocalError

闭包中的典型错误示例

比如想实现一个计数器：

def make_counter():
    count = 0
    def counter():
        count += 1  # ❌ 报错：UnboundLocalError
        return count
    return counter
<p>c = make_counter()
c()  # UnboundLocalError: local variable 'count' referenced before assignment</p>

这里 count += 1 等价于 count = count + 1，触发了“赋值即局部变量”的规则。虽然读取 count 时能找到外层的 count，但一赋值就要求它必须是局部变量——而它又没被初始化，所以出错。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

nonlocal 的作用就是显式声明“我要修改的是外层非全局变量”

修正方式很简单：

def make_counter():
    count = 0
    def counter():
        nonlocal count  # ✅ 告诉 Python：这个 count 是外层函数的变量
        count += 1
        return count
    return counter