如何重新加载以可编辑模式安装的Python包？

当使用pip install -e .安装的可编辑包无法通过importlib.reload()正常重新加载时，通常是因为该方法仅重新加载顶层模块，包内的子模块不会被自动递归刷新。以下是几种可行的解决方法：

方法1：递归重新加载所有子模块 #

编写递归函数遍历包的所有子模块并逐一重新加载，确保所有层级的代码都被刷新：

import importlib
import sys
from types import ModuleType

def deep_reload(module):
    loaded_modules = set()
    
    def reload_recursive(mod):
        if mod not in loaded_modules:
            loaded_modules.add(mod)
            importlib.reload(mod)
            # 遍历并重新加载当前模块下的子模块
            for attr_name in dir(mod):
                attr = getattr(mod, attr_name)
                if isinstance(attr, ModuleType) and attr.__name__.startswith(mod.__name__):
                    reload_recursive(attr)
    
    reload_recursive(module)

使用时直接调用deep_reload(your_package)即可。

方法2：卸载模块后重新导入 #

如果递归加载仍有问题，可以先从sys.modules中移除包的所有相关模块，再重新导入：

import sys
import importlib

def reload_editable_package(package_name):
    # 收集所有属于目标包的模块
    modules_to_remove = [name for name in sys.modules if name.startswith(package_name)]
    for name in modules_to_remove:
        del sys.modules[name]
    # 重新导入包
    return importlib.import_module(package_name)

调用示例：your_package = reload_editable_package("your_package_name")

方法3：交互式环境下使用IPython魔法命令 #

如果你在IPython或Jupyter环境中工作，可使用内置的autoreload魔法命令自动同步修改：

%load_ext autoreload
%autoreload 2

执行后，对包内文件的修改会自动同步到当前会话，无需手动调用reload。

需要注意的是，若模块中存在全局状态、单例对象等场景，以上方法可能无法完全刷新，此时重启Python解释器是最稳妥的方案。

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