Python全局变量已正确设置却返回None？疑因模块重复导入

问题场景 #

我在重构旧代码时，临时用context模块实现了一个简单单例来管理上下文，代码如下：

_context = None

def set_context(context):
  global _context

  # 省略错误检查逻辑
  _context = context
  return context

def get_context():
  if not _context:
    raise ValueError("Attempt to call context before it was initialized")

  return _context

但调试时遇到了诡异的问题：

• 明明set_context已经把_context设置好了，调用get_context时却返回None
• 在set_context里断点查看，本地的_context显示为None，但<my_project>.context._context却有有效数据
• 后来发现模块顶部的_context = None执行了两次，显然是同一个模块被加载了两次，导致出现了两个独立的实例，单例完全失效

为什么模块会被重复加载？ #

Python默认只会加载一次模块，但以下情况会打破这个规则：

• 导入路径不统一：比如一处用import context，另一处用from my_project import context，如果项目根目录不在sys.path里，Python会把这两个视为不同的模块
• 模块名冲突：自定义模块和标准库/第三方库重名，或者项目里有多个同名的context.py文件
• 调试工具干扰：部分IDE的热重载功能会重新加载模块，或者调试过程中模块被强制重新导入
• 手动修改sys.modules：如果代码里有删除sys.modules中模块条目的操作，下次导入时会重新加载模块

解决办法 #

1. 统一所有导入方式 #

全项目里只用同一种导入路径：

• 如果项目根目录在sys.path中，统一用绝对导入：from my_project import context 或者 import my_project.context as context
• 不要混用相对导入（比如from . import context）和绝对导入，除非你对模块结构有绝对把握

2. 排查模块名冲突 #

• 检查自定义的context模块是不是和标准库/第三方库重名了，要是重名就改个名字，比如app_context
• 看看项目里有没有多个context.py文件，尤其是不同子目录里的，避免导入错误的模块

3. 强制绑定模块实例的属性 #

绕过global变量的坑，直接通过sys.modules操作模块实例的属性，确保所有操作都针对同一个模块对象：

import sys

# 初始化上下文属性
if not hasattr(sys.modules[__name__], '_context'):
    sys.modules[__name__]._context = None

def set_context(context):
    # 直接修改模块实例的_context
    sys.modules[__name__]._context = context
    return context

def get_context():
    ctx = sys.modules[__name__]._context
    if not ctx:
        raise ValueError("Attempt to call context before it was initialized")
    return ctx

这种方式不管模块被导入多少次，只要sys.modules里的实例是同一个，就能保证上下文一致。

4. 检查IDE调试设置 #

• 关掉IDE的热重载功能（比如PyCharm里的“代码更改时自动重载”）
• 调试时避免触发模块重新加载的逻辑，比如不要在调试过程中修改模块代码后自动重启

5. 验证模块唯一性 #

在context模块顶部加一行打印，看看每次加载的模块实例ID：

import sys
print(f"Context module loaded: name={__name__}, id={id(sys.modules[__name__])}")

然后在所有导入该模块的地方也加类似打印，如果输出的ID不一样，说明导入路径肯定有问题，得统一路径。

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