Python 中使用 nonlocal 关键字修改外层嵌套作用域变量的完整教程-Python教程-PHP中文网

Python 中使用 nonlocal 关键字修改外层嵌套作用域变量的完整教程

本文详解如何在 Python 嵌套函数中安全、直接地修改外层（非全局）作用域的变量，重点介绍 nonlocal 语句的语法、使用场景、典型误区及替代设计建议。

本文详解如何在 python 嵌套函数中安全、直接地修改外层（非全局）作用域的变量，重点介绍 `nonlocal` 语句的语法、使用场景、典型误区及替代设计建议。

在 Python 中，函数内部默认只能读取外层嵌套作用域（enclosing scope）的变量，但无法直接赋值修改——一旦执行 var = ...，Python 就会将其视为定义局部变量，从而屏蔽外层同名变量。这正是原问题中 subfunction 内 var = 22 并未改变 function 中 var 值的根本原因。

要突破这一限制，必须显式声明变量属于外层而非局部作用域，此时 nonlocal 语句就是标准且唯一的解决方案。

✅ 正确用法：`nonlocal` 声明外层变量

nonlocal 必须在嵌套函数内部、赋值操作前声明，且所指变量必须存在于最近的外层非全局作用域中（即不能是全局变量，也不能是局部变量）。例如：

def function():
    var = 99  # 外层嵌套作用域变量（非全局！）

    def subfunction():
        nonlocal var  # 关键：声明 var 来自外层嵌套作用域
        var = 22
        print('subfunction', var)

    subfunction()  # 立即调用验证
    print('function', var)  # 输出：function 22

function()

? 注意：nonlocal var 不会查找全局变量 var（即使存在），也不会创建新变量；若指定变量在外层不存在，将触发 SyntaxError: no binding for nonlocal 'var' found。

A Python CLI skill for Cutout.Pro visual APIs — background removal, face cutout, and photo enhancement. Supports file upload & image URL input.
调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。

下载

? 应用于 tkinter 场景（修复原代码）

将 nonlocal 加入原 tkinter 示例，即可实现按钮点击后更新外层 var 并在 wait_window 返回后读取：

import tkinter as tk

def function():
    var = 99

    def subfunction():
        nonlocal var  # ← 核心修正：允许修改外层 var
        var = 22
        print('subfunction', var)
        top.destroy()

    top = tk.Toplevel(root)
    top.title('top level')
    tk.Button(top, text='Button toplevel', command=subfunction).pack()
    root.wait_window(top)  # 阻塞直至 top 销毁
    print('function', var)  # ✅ 现在输出：function 22

var = 0
root = tk.Tk()
print(var)
tk.Button(root, text='Button', command=function).pack()
root.mainloop()

⚠️ 重要注意事项

不可用于全局变量：修改全局变量应使用 global，而非 nonlocal；
作用域层级严格匹配：nonlocal x 只向上搜索第一个含 x 的 enclosing scope（如 outer → inner），跳过 global 和 local；
声明位置关键：必须在函数体内、首次赋值前声明，否则报 SyntaxError；
不支持动态名称：变量名必须静态可见，无法通过字符串或 exec 动态指定。