如何导入不在sys.path中的模块且避免污染sys.path路径？

核心思路是使用Python标准库importlib的底层导入接口，直接在指定路径下查找加载目标模块，全程不修改全局sys.path，从根源上避免路径污染，同时支持单文件模块和目录形式的包。

实现代码 #

你的库侧代码 #

import os
import sys
import importlib.util
from importlib.machinery import PathFinder

def load_module_out_of_path(module_name: str, parent_dir: str):
    # 优先尝试直接匹配模块路径
    module_path = os.path.join(parent_dir, module_name)
    spec = importlib.util.spec_from_file_location(module_name, module_path)
    # 兼容常规包、命名空间包的查找逻辑
    if not spec:
        spec = PathFinder.find_spec(module_name, path=[parent_dir])
    if not spec:
        raise ImportError(f"找不到模块 {module_name}，请检查父路径 {parent_dir} 是否正确")
    # 构造模块对象并注册到全局模块缓存
    module = importlib.util.module_from_spec(spec)
    sys.modules[module_name] = module
    # 执行模块内容完成加载
    spec.loader.exec_module(module)
    return module

# 调用示例，替换为你实际的模块名和父目录路径
load_module_out_of_path("my_module", "path/to/parent/dir")

用户侧代码 #

和原有用法完全一致，不需要做任何修改：

import my_module

方案优势 #

• 全程未修改全局sys.path，不会造成路径污染，完全规避父目录下其他模块和全局模块重名冲突的问题
• 不会出现临时修改sys.path期间，其他线程导入逻辑受影响的并发问题
• 支持所有Python模块形式：单文件模块、带__init__.py的常规包、Python 3.3+的命名空间包
• 基于官方标准库实现，不需要第三方依赖，兼容性和稳定性有保障
• 模块加载完成后，用户侧的导入、使用逻辑和普通安装的模块完全一致，没有额外适配成本
• 自动支持模块内的相对导入，不需要额外配置

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