Python 的内置函数 locals

Python 内建函数列表 > Python 的内置函数 locals

Python 的内置函数 locals() 是一个非常有用的工具函数，它返回一个字典，包含当前局部命名空间中的所有变量名及其对应的值。这个字典反映了函数或代码块中当前可访问的所有局部变量。

def locals():
    '''
    返回一个代表当前局部符号表的映射对象

    :return: 当前局部符号表的映射对象
    '''

功能详解：

1. 返回内容：locals() 返回的字典包含当前作用域中定义的所有局部变量，包括：

   • 函数内部定义的变量
   • 循环中的临时变量
   • 通过赋值语句创建的变量

2. 动态性：值得注意的是，当修改返回的字典时，实际上也会影响当前作用域中的变量值。不过这种行为在不同 Python 实现中可能有所差异，官方文档建议不要依赖这种修改行为。

3. 与 globals() 的区别：

   • locals() 返回局部命名空间
   • globals() 返回全局命名空间
   • 在模块级别调用时，两者返回的内容相同

典型应用场景：

1. 调试时查看变量：

   def calculation(x, y):
    temp = x * y
    print(locals())  # 查看当前所有局部变量
    return temp + 100
   
   calculation(1, 2)
   

注意事项：

• 在函数内部，locals() 只包含函数开始执行后定义的变量
• 在类方法中，不会包含实例属性（self.xxx）
• 由于性能考虑，CPython 的实现可能不会实时更新返回的字典

locals() 函数为 Python 程序员提供了一种强大的自省(introspection)能力，在调试、元编程和动态代码生成等场景中非常实用。