如何正确卸载指定模块的所有子模块？解决误删变量问题

我想要卸载mainmodule的所有子模块，因为它和另一模块存在冲突。我尝试了以下代码：

mainmodule_submodules = [key for key in sys.modules if key.startswith('mainmodule')]
for mainmodule_submodule in mainmodule_submodules:
    del mainmodule_submodule # deletes the variable mainmodule_submodule instead of the submodule that's stored in it
    del sys.modules[mainmodule_submodule]

但问题在于，del mainmodule_submodule只是删除了循环里的临时变量，并没有删掉它指向的实际子模块。请问该怎么正确操作？

正确解法 #

1. 移除无用的del mainmodule_submodule
   这行代码完全没必要，它只会删除循环迭代时生成的临时变量，对卸载模块没有任何作用，直接删掉即可。

2. 核心操作：清理sys.modules缓存
   sys.modules是Python存储已导入模块的缓存字典，删除其中对应模块名的键值对，才是真正从缓存中卸载模块的关键。

3. 额外清理命名空间引用
   如果你的代码其他地方（比如全局/局部命名空间）还持有这些子模块的引用，需要同步删除这些引用，否则Python的垃圾回收机制不会真正回收模块对象。比如用import mainmodule.submod或from mainmodule import submod导入的模块，要清理对应变量。

修正后的代码：

import sys

# 收集所有属于mainmodule的子模块名
target_modules = [mod_name for mod_name in sys.modules if mod_name.startswith('mainmodule')]

for mod_name in target_modules:
    # 从模块缓存中移除
    del sys.modules[mod_name]
    # 清理全局命名空间中的引用（如果存在）
    if mod_name in globals():
        del globals()[mod_name]
    # 若有局部命名空间的引用，可类似用locals()处理

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