Python跨模块场景下全局变量修改不可见的问题排查与解决

你遇到的问题和Python导入机制中入口模块的命名规则直接相关，和导入位置、可变对象特性无关：

• 当你直接执行./app.py时，Python会将这个文件作为顶层入口加载，对应的模块名是__main__，此时文件内定义的MY_DICT属于__main__模块的属性，也就是__main__.MY_DICT。
• 当代码执行到other.check_dict()内部的from app import MY_DICT时，Python会检查已加载的模块缓存，发现不存在名为app的模块（当前缓存里只有__main__和other），因此会重新读取app.py文件，将其作为一个全新的、名为app的模块加载，这个新模块内的MY_DICT是刚执行初始化的状态，即{'initial':10}，和你之前在__main__模块中修改的字典完全是两个独立的对象。
• 函数执行完回到app.py的主逻辑时，操作的始终是最开始__main__模块里的那个字典，因此值又变回修改后的状态。

简单说：同一个app.py文件被Python加载了两次，生成了两个完全独立的模块实例，各自持有独立的全局命名空间，你在两个实例里看到的MY_DICT根本不是同一个变量。

Python中不存在能跨所有模块直接生效的“超级全局变量”，跨模块共享状态的核心原则是：保证所有访问方引用的是同一个模块对象下的同一个属性。最稳妥、最符合Python社区惯例的做法是将共享状态抽离到独立的专用模块中：

1. 新建独立的状态存储文件，比如state.py，仅存放需要跨模块共享的变量：

# state.py
MY_DICT = {'initial': 10}

2. 修改app.py，从状态模块导入共享变量：

#!/usr/bin/env python3
import other
from state import MY_DICT


def main():
    print('before main:', MY_DICT)
    MY_DICT['foo'] = 20
    MY_DICT['bar'] = 30
    print('after changes:', MY_DICT)
    other.check_dict()
    print('back in main:', MY_DICT)


if __name__ == '__main__':
    main()

3. 修改other.py，同样从状态模块导入共享变量：

# other.py
from state import MY_DICT

def check_dict():
    print('inside other:', MY_DICT)

修改后执行./app.py会得到符合预期的输出：

before main: {'initial': 10}
after changes: {'initial': 10, 'foo': 20, 'bar': 30}
inside other: {'initial': 10, 'foo': 20, 'bar': 30}
back in main: {'initial': 10, 'foo': 20, 'bar': 30}

这种方案的可靠性来自Python的模块单例机制：同一个模块无论被导入多少次，在整个程序生命周期中只会被加载一次，所有导入方拿到的都是同一个模块对象的引用，对可变对象（比如字典、列表）的修改会同步到所有访问方。

以下方案可以解决当前场景的问题，但存在明显的设计缺陷，仅适合临时调试使用：

• 新增单独的入口文件，比如run.py，内容为from app import main; main()，后续执行python run.py启动程序。此时app.py不会被当作__main__加载，所有位置导入app模块都会拿到同一个实例，不会出现重复加载问题。但这种方式没有从根源上拆分状态和业务逻辑，后续如果出现循环导入、入口命名类问题，还是容易踩坑。
• 在other.py中直接从__main__模块导入变量，即写from __main__ import MY_DICT。这种方式耦合度极高，一旦other.py被其他非app.py的入口文件调用，会直接抛出导入错误，完全无法复用。

内容的提问来源于stack exchange，提问作者yeputons