本文介绍在使用 importlib.util 动态加载插件模块时，如何通过 spec_from_file_location 的 name 参数精确控制模块的 __name__ 值，从而支持类似 if __name__ == 'plugin': 的条件判断逻辑。
本文介绍在使用 `importlib.util` 动态加载插件模块时，如何通过 `spec_from_file_location` 的 `name` 参数精确控制模块的 `__name__` 值，从而支持类似 `if __name__ == 'plugin':` 的条件判断逻辑。
在构建可扩展的 Python 插件系统时，常需让插件模块感知自身加载上下文——例如区分“被插件管理器加载”与“作为脚本直接运行”。Python 原生依赖 __name__ 全局变量实现该语义（如 if __name__ == '__main__':），但动态加载时其值默认由文件路径推导，无法直接修改 globals() 中的 __name__（因其在模块执行前已被 exec_module 内部固化）。
关键洞察：__name__ 并非运行时可写入的普通全局变量，而是模块对象的元属性，由 importlib.util.spec_from_file_location() 的第一个参数 name 显式指定。
因此，正确做法不是事后修改 globals()，而是在创建模块规范（ModuleSpec）阶段就传入期望的模块名：
import importlib.util
import os
def load_plugin(self, dirname):
filename = os.path.join(dirname, 'myplugin.py')
file_path = os.path.join(self.plugin_dir, filename)
# ✅ 正确方式：将 __name__ 设为自定义标识符（如 'plugin'）
module_name = 'plugin' # 或 '__my_plugin__', 'myplugin_v1' 等语义化名称
spec = importlib.util.spec_from_file_location(module_name, file_path)
module = importlib.util.module_from_spec(spec)
spec.loader.exec_module(module) # 此时 module.__name__ == 'plugin'
return module
加载后，插件模块内即可使用标准 __name__ 判断逻辑：
# myplugin.py
if __name__ == 'plugin':
print("✅ 正确加载为插件模块")
elif __name__ == '__main__':
print("⚠️ 此文件被直接执行（非插件模式）")
else:
print(f"ℹ️ 模块名为: {__name__}")
注意事项：
- 避免使用
__main__作为自定义module_name，否则会干扰if __name__ == '__main__':的语义，导致误判； -
module_name应全局唯一，防止命名冲突（尤其当多插件同名时）； -
__name__的值仅影响该模块自身的__name__变量，不影响其内部导入的其他模块； - 若需向插件注入额外上下文（如配置、回调函数），应通过
module对象属性或显式函数参数传递，而非篡改globals()。
通过这一机制，你既能保持 Python 原生模块语义的一致性，又能为插件系统构建清晰、可靠、符合直觉的加载状态识别能力。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
