本文介绍如何从外部模块安全、可靠地访问并执行 `__main__` 模块中以特定前缀（如 `auto_`）命名的函数，无需重构为类或显式传参，核心依赖 `sys.modules["__main__"]` 获取主模块对象。
在 Python 中，__main__ 并非仅是一个特殊名称，而是一个真实存在的模块对象，其生命周期与脚本启动同步。它被自动注册到 sys.modules 字典中，键为字符串 "__main__"。这意味着——只要脚本尚未退出，任何导入的模块均可通过 sys.modules["__main__"] 获取对它的引用，进而读取其全局命名空间、检查函数定义，并直接调用。
以下是一个完整可运行的示例：
my_module.py（外部工具模块）：
import sys
def run_all_auto():
"""查找并调用 __main__ 中所有以 'auto_' 开头的可调用对象"""
main_module = sys.modules["__main__"]
for name, obj in vars(main_module).items():
if name.startswith("auto_") and callable(obj):
print(f"→ 调用 {name}()")
try:
obj()
except Exception as e:
print(f" ❌ {name} 执行失败: {e}")main.py（主脚本）：
立即学习“Python免费学习笔记（深入）”；
from my_module import run_all_auto
def auto_setup():
print("✅ 初始化配置")
def auto_migrate():
print("✅ 执行数据库迁移")
def auto_test():
print("✅ 运行单元测试")
def manual_helper():
print("⚠️ 此函数不会被自动调用")
if __name__ == "__main__":
print("开始执行自动任务...")
run_all_auto() # 输出三行 ✅，跳过 manual_helper运行 python main.py 将输出：
开始执行自动任务... → 调用 auto_setup() ✅ 初始化配置 → 调用 auto_migrate() ✅ 执行数据库迁移 → 调用 auto_test() ✅ 运行单元测试
⚠️ 注意事项与最佳实践：
- ✅ 始终使用 callable(obj) 校验——避免将同名变量（如 auto_flag = True）误判为函数；
- ✅ 推荐添加异常捕获，防止单个 auto_ 函数崩溃导致后续任务中断；
- ⚠️ 该方法依赖 __main__ 的全局状态，在交互式环境（如 IPython/Jupyter）中行为可能不一致，生产代码中应谨慎使用；
- ? 不适用于冻结打包（如 PyInstaller）后的单文件应用，因 __main__ 模块结构可能被重写；
- ? 若需更高可控性，可扩展为支持装饰器标记（如 @auto_task）或配置白名单，兼顾灵活性与可维护性。
本质上，这是一种“反射式自动化”技巧，适用于快速原型、CLI 工具初始化或教学演示场景。但长期项目中，仍建议通过显式注册、插件系统或配置驱动方式替代隐式命名约定，以提升可读性与可测试性。
