绝大多数动态导入场景应使用importlib.import_module()；__import__()仅用于底层import hook开发，日常业务中易引发路径解析错误、相对导入失败等问题。
动态导入模块时，importlib.import_module() 和 __import__() 怎么选
绝大多数动态导入场景，直接用 importlib.import_module() 就够了；__import__() 仅在极少数需要模拟 import 语句内部行为（比如实现自己的 import hook）时才碰得到，日常写业务代码几乎不用。
常见错误是看到文档里提了 __import__() 就去模仿，结果搞出路径解析错乱、相对导入失败、sys.modules 状态不一致等问题。它不处理包层级，也不自动缓存，得自己补一堆逻辑。
-
importlib.import_module("os.path")→ 正确，支持点号分隔的完整模块名 -
__import__("os.path")→ 实际返回的是os模块，不是os.path，容易误判 - 如果模块名来自用户输入或配置文件，必须做白名单校验，否则可能触发任意模块加载（如
"subprocess"）
从字符串路径加载模块：用 importlib.util.spec_from_file_location() 而非硬编码 sys.path
想从某个具体 .py 文件路径导入（比如插件目录、临时脚本），别手动往 sys.path 插路径再调 import_module() —— 这会污染全局导入环境，多线程下尤其危险，而且模块重载逻辑难控制。
正确做法是走 spec + loader 流程，完全隔离作用域：
立即学习“Python免费学习笔记（深入）”；
import importlib.util
spec = importlib.util.spec_from_file_location("my_plugin", "/path/to/plugin.py")
module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(module)
注意：spec_from_file_location() 第二个参数必须是绝对路径；如果是相对路径，要用 os.path.abspath() 或 pathlib.Path.resolve() 先转正。
- 模块不会自动进入
sys.modules，除非你显式赋值：sys.modules["my_plugin"] = module - 如果该文件依赖其他本地模块，它们不会被自动发现——要提前把对应目录加进
sys.path，或改用importlib.util.spec_from_loader()配合自定义 loader - Python 3.4+ 才有这套 API，旧版本只能退回到
imp.load_source()（已弃用，不推荐）
热重载模块时，importlib.reload() 的三个硬限制
importlib.reload() 看似能“刷新”已导入模块，但实际只重执行模块顶层代码，对已存在的对象引用、类实例、函数闭包完全无效。它不是万能热更新开关。
典型翻车现场：改了某个工具函数，reload 后老对象还在用旧版方法；或者 reload 了定义类的模块，但已有实例的 __class__ 指针没变，导致新旧类混用报 TypeError。
- 只能 reload 已存在于
sys.modules中的模块，首次导入必须用import或import_module() - reload 后，所有通过该模块导出的变量（如
from mod import func）不会自动更新，调用的仍是旧对象 - 如果模块里用了
atexit.register()或修改了全局状态（如 logging 配置），reload 不会清除这些副作用
跨环境导入时，为什么 importlib.resources 比 pkg_resources 更稳
读取包内数据文件（比如 JSON 配置、模板、图标），现在应该无条件用 importlib.resources（3.7+）或 importlib_resources（兼容旧版）。pkg_resources 在 PEP 517/518 构建环境下经常找不到资源，尤其在使用 pip install -e . 或 Poetry 时。
关键区别在于：前者基于 import system 原生机制，后者依赖 egg-info 元数据，在现代打包流程中越来越不可靠。
- Python 3.9+ 推荐用
importlib.resources.files()返回Traversable对象，支持.joinpath()和.read_text() - 旧版本（3.7–3.8）用
importlib.resources.open_binary()或.read_text()，注意传入模块对象，不是字符串名 - 不要拼接路径字符串，比如
os.path.join(os.path.dirname(__file__), "data.json")—— 这在 zipimport 或某些打包格式下直接失效
真正麻烦的从来不是怎么写那一行 import，而是模块生命周期、路径解析上下文、以及 reload 后对象身份是否还一致。这些地方一松劲，问题就藏在运行时等你半夜三点收到告警。
