如何迁移Python函数至模块且不破坏兼容性、避免循环导入？

我之前重构模块时也碰到过一模一样的问题，你的方案c虽然能跑，但确实有更简洁优雅的方式搞定，还能完美避开循环导入的坑。

先理清楚背景：

• 原本fmod.py里有f()和g()两个函数
• 现在把g()迁移到了gmod.py，但得保留fmod.g()的调用方式兼容老代码
• 之前试的方案a、b都栽在循环导入上（gmod依赖fmod，fmod又直接导入gmod，互相卡死）
• 方案c用函数内延迟导入能行，但代码显得有点啰嗦

最优方案：用Python 3.7+的模块级__getattr__方法 #

在fmod.py里这么写就够了：

def f(x):
    print(x)

def __getattr__(name):
    if name == "g":
        from gmod import g
        return g
    raise AttributeError(f"module {__name__} has no attribute {name}")

为什么这个方案更优？ #

• 彻底规避循环导入：只有当外部代码真的访问fmod.g时，才会触发gmod的导入，而不是fmod一加载就去导入gmod，完美解决了模块互相依赖的问题
• 代码简洁优雅：不用额外写包装函数，利用Python原生的模块属性查找机制实现兼容层
• 自动缓存复用：第一次访问fmod.g时完成导入并缓存引用，后续访问直接用缓存的结果，完全没性能损耗
• 语义清晰：明明白白告诉维护者，g是动态从gmod导入的兼容属性，一看就懂

和方案c的对比优势 #

方案c每次调用fmod.g()都会执行一次import gmod（虽然Python会缓存模块不会重复加载，但代码冗余感还是很强），而__getattr__的方式只会在第一次访问fmod.g时执行一次导入逻辑，后续直接复用，代码更干净，也更贴合Python的设计哲学。

如果你的项目还需要兼容Python 3.6及以下版本（现在已经很少见了），可以把方案c优化成只在第一次调用时导入，但__getattr__无疑是最现代、最简洁的解决方案。

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