globals() 返回当前模块的全局变量字典,不跨模块;修改它会直接改变命名空间,但易引发维护问题,应优先用 setattr() 或专用配置对象替代。

globals() 返回的是当前模块的全局变量字典,不是所有 Python 进程的全局变量
很多人误以为 globals() 能拿到整个解释器里所有模块定义的变量,其实它只返回**当前执行上下文所在模块的全局命名空间**——也就是你写 globals() 那一行代码所在的 .py 文件顶层作用域。跨模块访问要用 import 显式导入,不能靠 globals() “扫描”出来。
常见错误现象:globals() 在函数内部调用,却期望看到函数外定义的变量(实际能看到,因为函数内默认可读全局变量);或者在子模块里调用,想获取主模块的变量(拿不到,除非主模块把变量传进来或设为 global)。
- 函数内调用
globals(),仍能访问模块级变量,但不会包含局部变量(locals()才管局部) -
globals()返回的是一个真实字典,修改它等于直接改模块的全局命名空间——这很危险,但确实可行 - 在交互式环境(如 IPython)中,
globals()包含所有已执行语句定义的名称,容易造成混淆
动态赋值别直接写 globals()['x'] = 1,优先用 setattr() 或 importlib.import_module
直接对 globals() 字典赋值看似简单,比如 globals()['CONFIG_PATH'] = '/etc/app.conf',但它绕过了 Python 的变量声明逻辑,IDE 和类型检查工具(如 mypy)完全无法感知,后续引用 CONFIG_PATH 时可能报未定义,调试也难定位来源。
更稳妥的做法是:如果目标是“按字符串名设置模块级变量”,优先走 setattr(sys.modules[__name__], name, value);如果变量来自其他模块,用 importlib.import_module() 加 setattr() 组合。
立即学习“Python免费学习笔记(深入)”;
-
setattr(sys.modules[__name__], 'DEBUG', True)效果等价于DEBUG = True,且 IDE 可索引 - 避免在循环里反复调用
globals()并修改,容易引发命名冲突或覆盖内置变量(比如不小心写globals()['list'] = []) - 若必须用字典方式批量注入,先用
if key not in globals():检查,防止覆盖已有变量
globals() 在 exec() 和 eval() 中的行为容易被误解
当用 exec() 执行字符串代码时,如果不显式传入 globals 和 locals 参数,它会使用当前作用域的 globals() 和一个新字典作为 locals()。这意味着你在 exec() 里定义的变量,默认**不会出现在当前模块的 globals() 中**——除非你手动把 locals() 合并回去,或者传入同一个字典。
典型翻车场景:运行 exec("x = 42") 后立刻查 globals().get('x'),结果是 None。
- 安全做法:显式传参,如
exec(code, globals(), globals())(让 locals 和 globals 同字典) - 更推荐:用独立字典隔离
exec()环境,避免污染主命名空间,例如ns = {}; exec(code, ns); print(ns.get('x')) -
eval()只能求值表达式,不支持赋值语句,所以eval("x = 42")直接抛SyntaxError
globals() 不适合做配置管理或状态中心
有人用 globals() 存配置项、开关标志甚至缓存数据,觉得“方便”。问题在于:它没有访问控制、无生命周期管理、不支持嵌套结构、难以测试——一旦模块变大,谁在什么时候写了什么,全靠人肉追踪。
真正需要动态变量管理的场景,应该用专用结构:比如 config = types.SimpleNamespace()、dataclasses 实例,或单例类。这些方案支持属性补全、类型提示、单元测试 mock,而 globals() 全都不行。
- 临时脚本小工具里用
globals()快速调试可以,但上线前务必替换 - 用
globals()实现“插件式变量注册”?大概率后期变成维护噩梦,改个变量名都得 grep 全项目 - 性能上没差异,但可读性和可维护性断崖下跌——这点比任何技术细节都关键
真正难的从来不是怎么调用 globals(),而是意识到:它暴露的是 Python 的底层机制,不是设计给日常业务逻辑用的接口。越早把它从“顺手工具”降级为“必要时才碰的底层操作”,项目越不容易长出奇怪的依赖和隐式耦合。










