Python拦截导入需向sys.meta_path前端插入自定义Finder，实现find_spec方法返回ModuleSpec，并清理sys.modules缓存，否则导入仍走原路径。
Python中拦截导入需要替换sys.meta_path
Python的模块导入机制默认走sys.meta_path里的查找器（finder）链，想拦截就得往这个列表里插入自定义finder。不能动sys.path_hooks或sys.path——那些只影响基于路径的查找，对importlib.util.spec_from_loader等直接构造的导入无效。
常见错误是试图用__import__或importlib.__import__去hook，这只能捕获顶层import语句，对内部递归导入、from x import y、甚至importlib.import_module调用完全失效。
- 自定义finder必须实现
find_spec方法（Python 3.4+），返回ModuleSpec或None - 如果要重定向，比如把
requests指向本地mock版本，就在find_spec里判断fullname == 'requests'，然后用importlib.util.spec_from_file_location构造新spec - 务必在
sys.meta_path头部插入finder：sys.meta_path.insert(0, MyFinder())，否则可能被内置finder提前命中
重定向时要注意loader和module对象的生命周期
光改spec不够——spec里的loader决定模块怎么加载。如果直接复用原loader（比如spec.loader），重定向就白做了；如果自己写loader，必须实现create_module和exec_module，否则import会报ImportError: loader doesn't define exec_module。
更隐蔽的问题是module缓存：sys.modules会在首次导入后缓存模块对象。如果你在finder里返回了新spec，但sys.modules里已有同名旧模块，Python会直接返回缓存，根本不调用你的loader。
立即学习“Python免费学习笔记（深入）”；
- 拦截前先清理缓存：
sys.modules.pop('target_module', None) - loader的
exec_module里别漏掉mod.__name__ = fullname，否则模块内__name__变成'__main__'或空字符串 - 若重定向到源码文件，注意
__file__属性要设为真实路径，否则inspect.getsource等会失败
实际场景：测试中替换第三方模块
比如单元测试时想让所有对urllib.request的导入都指向tests.mock_urllib，而不是真正发HTTP请求。这时不能只patch urllib.request.urlopen，因为有些库会直接import urllib.request再用urllib.request.build_opener。
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
一个轻量方案是写个最小finder：
class MockImporter:
def find_spec(self, fullname, path, target=None):
if fullname == 'urllib.request':
# 指向本地mock文件
mock_path = Path(__file__).parent / 'mock_urllib.py'
return importlib.util.spec_from_file_location(fullname, mock_path)
return None
sys.meta_path.insert(0, MockImporter())
注意这个finder必须放在测试setup里执行，且teardown时从sys.meta_path删掉它——否则会影响后续测试或导入其他模块。
- 不要在
find_spec里做耗时操作（如读文件、网络请求），导入是同步阻塞的 - 避免匹配过宽：
if 'urllib' in fullname会误伤urllib.parse，应精确匹配 - 重定向后，原模块的C扩展（如
urllib.parse里的_urlparse）不会被加载，mock文件需纯Python实现
为什么不用importlib.abc.Loader继承？
直接继承importlib.abc.Loader看似规范，但容易踩坑：Python 3.12开始要求loader必须实现create_module，而很多旧教程示例只写了exec_module。更麻烦的是，如果loader返回的module对象没设置__spec__，某些工具（如pytest的插件、mypy）会报AttributeError: 'module' object has no attribute '__spec__'。
稳妥做法是复用importlib.util.spec_from_file_location生成spec，再用spec.loader（它已经是完整loader）——这样既省事又兼容。
- 别手动new module对象：
types.ModuleType(fullname)之后忘了设__spec__，会导致importlib.reload失败 - 如果重定向目标是包（含
__init__.py），spec的submodule_search_locations必须设为list，否则from pkg import sub会找不到子模块 - 多线程下
sys.meta_path是全局的，修改前最好加锁，或确保只在单测隔离环境中操作
模块导入拦截不是黑魔法，本质是理解Python导入协议的三步：finder找spec → loader加载 → module缓存。每一步都有明确接口和约束，绕开任何一环都会导致行为不一致。最常被忽略的是缓存清理和spec完整性——这两点出问题，表现就是“明明写了拦截，但import还是走原路”。
