如何保留import语句的前提下用同名文件夹覆盖已导入的Python包

Python 导入模块时会将已经加载的模块缓存到sys.modules字典中，后续所有导入同名模块的操作都会直接返回缓存中的对象，不会重新遍历sys.path查找，因此你提前导入了默认路径下的package_name后，再修改sys.path也不会触发重新加载。

方案1：清除缓存后重新导入（全局替换） #

如果需要全局替换使用subdir下的package_name，可以在修改sys.path后先删除缓存的旧模块，再重新导入：

import sys
import package_name

if condition:
    sys.path.insert(0, subdir)
    # 清除已缓存的旧模块
    if 'package_name' in sys.modules:
        del sys.modules['package_name']
    # 此时重新导入会优先从subdir查找
    import package_name

# 后续调用就是subdir下的版本
package_name.function()

注意：如果package_name存在子模块，需要将缓存中所有package_name.xxx格式的子模块一并删除，否则子模块还是会沿用旧版本。如果其他地方提前持有旧模块的对象引用，该引用不会自动更新，需要重新从新导入的模块获取。

方案2：单独加载自定义包（不影响全局导入） #

如果需要同时保留两个版本的包使用，可以用importlib手动加载subdir下的包，避免修改全局缓存的默认行为：

import sys
import importlib.util
# 原有包重命名保留
import package_name as original_package

if condition:
    # 手动构造subdir下包的入口文件路径
    package_init_path = f"{subdir}/package_name/__init__.py"
    # 加载自定义包
    spec = importlib.util.spec_from_file_location("custom_package", package_init_path)
    custom_package = importlib.util.module_from_spec(spec)
    spec.loader.exec_module(custom_package)

# 调用subdir下的版本
custom_package.function()
# 调用原有版本
original_package.function()

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