locals() 局部命名空间
最后更新：2026-09-22
locals() 局部命名空间
locals() 返回当前作用域的局部命名空间字典。
| 分类 | 内置函数 |
|---|---|
| 类型 | 内置函数 |
| Python 版本 | all |
📝 语法
locals()返回值：返回当前作用域的局部命名空间字典，键为变量名，值为对应对象。
▶ 示例
编辑下方代码，点击运行，在输出面板查看结果：
运行结果：
['a']🏷️ 相关内置函数
💡 相关案例
更多实战案例即将上线，敬请期待。
❓ 常见问题
Qlocals() 在函数里返回什么？
A返回当前函数作用域的局部变量字典，包含所有已定义的局部变量（含参数）。
Q在模块顶层 locals() 和 globals() 一样吗？
A一样，模块顶层“局部即全局”，两者返回同一个字典。
Q通过 locals()['x'] = 1 能改局部变量吗？
A在函数内修改返回的字典通常不会真正改变局部变量（CPython 中函数内 locals() 返回的是快照），不要依赖这种方式。
Qlocals() 有什么用？
A调试时快速查看当前作用域所有变量，或配合 eval/exec 传入局部命名空间控制执行环境。
