在 Python 中，变量的使用查找遵循明确且稳定的作用域规则，核心是 **LEGB 规则（Local、Enclosing、Global、Built-in）**。也就是说，当解释器遇到一个变量名时，会按照“局部作用域 → 外层函数作用域 → 全局作用域 → 内建作用域”的顺序逐层查找，直到找到为止；如果四层都未命中，就会抛出 `NameError`。理解这一查找顺序，是掌握 Python 变量机制、避免命名冲突、编写可维护代码的关键基础。

---

## 一、Python 变量查找机制概述

Python 变量查找规则，本质上是解释器在执行代码时的名称解析（Name Resolution）过程。与部分静态语言不同，Python 在运行时根据作用域链动态决定变量绑定位置。这种变量作用域机制既保证了灵活性，也可能带来命名覆盖问题。

Python 采用 **词法作用域（Lexical Scope）**，也称为静态作用域。也就是说，变量的可访问范围在代码编写时就已经确定，而不是在运行时动态决定。变量查找规则与代码的结构层级直接相关，而不是函数的调用顺序。

在实际开发中，理解 Python 变量查找顺序有助于避免变量污染、意外覆盖、调试困难等问题。特别是在函数嵌套、闭包、全局变量修改等场景中，正确理解作用域规则至关重要。

---

## 二、LEGB 规则详解

Python 官方文档在《Execution model》中明确指出名称解析遵循 LEGB 规则（Python Documentation, 2023）。LEGB 分别代表：

| 层级 | 英文 | 中文说明 | 查找优先级 |
|------|------|----------|------------|
| L | Local | 当前函数内部 | 最高 |
| E | Enclosing | 外层嵌套函数 | 第二 |
| G | Global | 当前模块全局 | 第三 |
| B | Built-in | Python 内建命名空间 | 最低 |

当解释器查找变量时，会严格按照上述顺序逐层查找。一旦找到匹配名称，即停止查找。

例如：

```python
x = "global"

def outer():
    x = "enclosing"
    def inner():
        x = "local"
        print(x)
    inner()

outer()
```

输出结果为 `local`，因为解释器在 Local 层级就已找到变量 x。

**LEGB 规则是 Python 变量使用查找的核心原则，是所有作用域行为的基础。**

---

## 三、Local 局部作用域

局部作用域（Local Scope）指的是函数内部定义的变量。函数每次调用时都会创建新的局部命名空间。

```python
def func():
    a = 10
    print(a)

func()
```

这里变量 a 只存在于函数 func 内部。函数执行完毕后，其局部变量会被销毁。

如果在函数内部引用一个未定义的变量，解释器会按照 LEGB 顺序向外查找。但如果在函数内部赋值某变量，Python 会默认将其视为局部变量。

例如：

```python
x = 5

def test():
    print(x)
    x = 10
```

运行会报错：`UnboundLocalError`。因为 Python 认为 x 是局部变量，但在赋值前被引用。

这说明 **变量是否为局部变量由赋值行为决定，而不是查找行为决定。**

---

## 四、Enclosing 嵌套作用域

嵌套作用域（Enclosing Scope）出现在函数内部定义函数的情况，也称闭包作用域。

```python
def outer():
    x = 20
    def inner():
        print(x)
    inner()

outer()
```

输出为 20。此时 inner 函数会向外查找 outer 的局部变量。

在 Python 3 中，嵌套作用域默认开启（Python 2 需 from __future__ import）。根据 PEP 227（2001），Python 正式支持嵌套作用域，这是闭包机制的基础。

如果需要修改外层变量，需要使用 `nonlocal`：

```python
def outer():
    x = 10
    def inner():
        nonlocal x
        x = 20
    inner()
    print(x)
```

输出为 20。

**nonlocal 明确告诉解释器：变量来自外层函数，而不是局部。**

---

## 五、Global 全局作用域

全局作用域指当前模块的顶层变量。模块内所有函数都可以访问全局变量。

```python
x = 100

def func():
    print(x)

func()
```

输出 100。

如果要在函数内部修改全局变量，必须使用 `global` 关键字：

```python
x = 100

def func():
    global x
    x = 200

func()
print(x)
```

输出 200。

如果不使用 global，Python 会默认创建局部变量。

需要注意：**频繁使用 global 会破坏代码可维护性，应谨慎使用。**

---

## 六、Built-in 内建作用域

内建作用域包含 Python 内置函数和异常，如：

- print
- len
- int
- Exception

例如：

```python
print(len("abc"))
```

len 来自内建命名空间。

可以查看内建变量：

```python
import builtins
dir(builtins)
```

如果定义变量名与内建函数相同，会覆盖内建引用：

```python
len = 10
print(len)
```

此时 len 不再是函数。

**覆盖内建名称是常见错误，属于变量查找规则中的风险点。**

---

## 七、变量查找过程对比示例

下表对不同场景的变量查找结果进行对比：

| 场景 | 是否赋值 | 使用关键字 | 查找结果 | 是否报错 |
|------|----------|------------|----------|----------|
| 函数内部只读全局变量 | 否 | 无 | Global | 否 |
| 函数内部赋值同名变量 | 是 | 无 | Local | 可能报错 |
| 修改全局变量 | 是 | global | Global | 否 |
| 修改外层函数变量 | 是 | nonlocal | Enclosing | 否 |
| 覆盖内建函数 | 是 | 无 | Local/Global | 否 |

该表说明，**变量查找与变量绑定是两个不同阶段的机制。**

---

## 八、作用域与性能关系

根据 Python 官方文档说明，局部变量访问速度最快，其次是全局变量，内建变量最慢（Python Docs, 2023）。

这是因为：

- 局部变量存储在快速数组中
- 全局变量存储在字典中
- 内建变量需要多层查找

在性能敏感代码中，常将全局函数赋值为局部变量：

```python
local_len = len
```

这种优化方式在大量循环中可提升性能。

虽然现代 Python 优化较好，但理解变量查找成本仍有价值。

---

## 九、常见错误与最佳实践

在实际 Python 编程中，变量查找规则常导致以下问题：

第一，变量遮蔽（Shadowing）。局部变量覆盖全局变量，影响调试。

第二，误用 global。导致函数副作用扩大。

第三，误覆盖内建名称，如 list、str。

最佳实践包括：

- 尽量使用函数参数代替全局变量
- 避免与内建名称重名
- 需要修改外层变量时使用 nonlocal
- 遵循清晰的命名规范

在大型项目中，良好的变量作用域设计可以显著提升代码可维护性与可测试性。

---

## 参考与资料来源

Python Documentation – Execution model, Naming and binding, 2023  
PEP 227 – Statically Nested Scopes, Guido van Rossum, 2001  

---

## 总结与趋势展望

Python 变量使用查找规则本质是 LEGB 作用域链机制，从局部到内建逐级查找，结合 global 与 nonlocal 关键字实现精细控制。理解变量查找顺序不仅能避免常见错误，还能提升代码性能与结构清晰度。

未来 Python 在作用域机制上的改动可能更多集中在性能优化与解释器实现层面，而不会改变 LEGB 这一核心设计。随着 Python 在数据科学、人工智能、自动化领域的广泛应用，清晰掌握变量查找规则将成为开发者的基础能力之一。

只有真正理解变量查找背后的设计思想，才能写出高质量、可维护、可扩展的 Python 代码。

Python变量的查找遵循LEGB规则，依次在局部作用域（Local）、闭包函数作用域（Enclosing）、全局作用域（Global）和内置作用域（Built-in）中查找变量名，找到第一个匹配的变量后停止查找。

变量查找的规则

我在Python代码里使用一个变量时，Python是怎么找到这个变量的实际值的？

Python中变量是如何被定位的？

Python按照LEGB顺序优先使用最近的变量。也就是说，首先查找局部作用域中的变量，如果没有则查找闭包函数作用域，然后查看全局作用域，最后才查看内置作用域。

变量优先级

当同一个变量名同时出现在函数内、函数外和内置模块中时，Python会选择哪个变量？

如果一个变量名在多个作用域中都存在，Python会优先使用哪个？

可以通过合理命名变量、使用全局变量时显式声明global关键字、避免不必要的嵌套函数以及理解Python变量作用域规则，避免变量在多个作用域中重名来防止冲突。

避免作用域冲突的方法

在写Python程序时，怎样才能防止变量名在不同作用域之间产生冲突？

如何避免变量查找时出现意外的作用域冲突？

PingCodeDocs

Python变量查找遵循LEGB规则，即按局部、外层嵌套、全局、内建的顺序逐级解析名称，找到即停止，否则抛出错误。变量是否被视为局部取决于是否在当前作用域赋值，修改全局或外层变量需使用global或nonlocal关键字。理解这一作用域机制不仅有助于避免变量遮蔽和命名冲突，还能提升代码结构清晰度与运行效率，是掌握Python编程的核心基础。

python变量使用查找的规则

用户关注问题