Python locals() 当前本地符号表的字典

Python 的内置函数 locals() 更新并返回表示当前本地符号表的字典，它没有可传入的参数。 在函数代码块但不是类代码块中调用 locals() 时将返回自由变量。 请注意在模块层级上，locals() 和 globals() 是同一个字典。Python 的命名空间通过一种字典的形式来体现, 而具体到函数也就是 locals() 和 globals(), 分别对应着局部命名空间和全局命名空间。

示例

一些示例如下：

# 在终端输入
locals()
# 输出（已美化格式）
{'__name__': '__main__',
 '__doc__': None,
 '__package__': None,
 '__loader__': <class '_frozen_importlib.BuiltinImporter'>,
 '__spec__': None,
 '__annotations__': {},
 '__builtins__': <module 'builtins' (built-in)>
}

# 1 对象没有__dict__ 属性
vars(1)
# TypeError: vars() argument must have __dict__ attribute

class Foo:
    def __init__(self):
        self.__dict__ = {'name':'Foo'}

f = Foo()

# 再终端执行
locals()
# 输出（已美化格式）
{'__name__': '__main__',
 '__doc__': None,
 '__package__': None,
 '__loader__': <class '_frozen_importlib.BuiltinImporter'>,
 '__spec__': None,
 '__annotations__': {},
 '__builtins__': <module 'builtins' (built-in)>,
 'Foo': <class '__main__.Foo'>,
 'f': <__main__.Foo object at 0x7fccf35f5120>
}
# 注意最后两项

我们进行赋值操作时，如 bar = 1，执行赋值语句后，名称 bar 引用到值 1，名字为键，将我们要取这个值时，可以用 vars() 返回的字典里用此键取得其引用值：

bar = 1
locals()['bar']
# 1
'bar' in locals().keys()
# True

注意：

不要更改此字典的内容，更改不会影响解释器使用的局部变量或自由变量的值。

相关内置函数的区别

以下是几个相关内置函数对比表：

Python globals() locals() vars() 三个内置函数的区别：

• globals() 始终返回模块命名空间的字典
• locals() 始终返回当前命名空间的字典
• vars() 返回当前命名空间的字典（如果调用时没有参数）或对象的字典

更多：

• globals()
  • 作用：返回当前全局符号表, 通常在是返回当前模块下的全局符号表, 比如全局内建的函数,以及模块里的全局符号(定义声明的变量,类, 实例等), 在函数或者类方法中, globals()
  • 返回的模块符号表是其所在模块, 而不是调用模块.
• locals()
  • 作用：更新并以字典形式返回当前局部符号表. 自由变量由函数块的 locals() 返回, 而不会由 class 块来返回. 需要注意的是, locals() 字典不应该被修改
• vars()
  • 作用：返回 __dict__ 属性
  • 比如模块、类、实例或者其它带有 dict 属性的 object.
  • vars() 使用时如果不传参数, 那么作用与 locals() 一样. 需要注意的是, locals 字典只在读操作时使用, 因为对 locals 的更新会被忽略.

注意：

locals 和 vars 需要再解释一下。如果在函数中调用了 locals()，它将使用当前局部变量名称空间（加上任何闭包变量）的值更新 dict，并返回它。在同一栈帧中多次调用 locals()，每次都返回相同的 dict——它作为 f_locals 属性附加到栈帧对象。dict 的内容在每次 locals() 调用和每个 f_locals 属性访问时更新，但仅在此类调用或属性访问时更新。分配变量时，它不会自动更新，在dict 中分配条目不会分配相应的局部变量：

import inspect

def f():
    x = 1
    l = locals()
    print(l) # {'x': 1}
    locals()
    print(l) # {'x': 1, 'l': {...}}
    x = 2
    print(x, l['x']) # 2 1
    l['x'] = 3
    print(x, l['x']) # 2 3
    inspect.currentframe().f_locals
    print(x, l['x']) # 2 2

f()
# 输出
'''
{'x': 1}
{'x': 1, 'l': {...}}
2 1
2 3
2 2
'''

第一次 print(l) 只显示一个“x”条目，因为对l的赋值发生在 locals() 调用之后。再次调用 locals() 后的第二个 print(l) 显示了一个l条目，尽管我们没有保存返回值。第三次和第四次打印显示，赋值变量不会更新l，反之亦然，但在访问 f_locals 后，局部变量会再次复制到 locals() 中。

参考

• https://stackoverflow.com/questions/7969949/whats-the-difference-between-globals-locals-and-vars
• https://www.cnblogs.com/wanstack/p/7286328.html
• https://codingdict.com/article/22137

更新时间：March 27, 2022, 11:22 a.m. 标签：python locals 符号 字典