Python包重构文件名时保障向后兼容的正确处理方式是什么

你当前的实现方案是完全规范的 #

你提到的保留A.py、通过导入语句重定向到B的实现是Python社区公认的标准模块重构兼容方案，没有规范性问题，绝大多数场景下都可以直接使用。 #

可选优化方案 #

如果需要更完善的能力，可以根据你的需求叠加以下优化：

1. 增加弃用提醒（计划后续下线A模块时使用） #

如果后续有彻底删除A.py的计划，可以在A.py中加入弃用警告，提前通知使用者迁移调用路径：

import warnings
# stacklevel=2 可以让警告指向调用方的导入位置，而不是当前A.py的代码行
warnings.warn(
    "Module A is deprecated, please import from module B instead",
    DeprecationWarning,
    stacklevel=2
)
from .B import func
# 保持和原A模块一致的导出列表，保证`from A import *`用法兼容
__all__ = ["func"]

2. 大量导出对象时简化代码 #

如果A模块原有的导出对象很多，不需要逐个写导入语句，可以用两种方式简化：

• 直接批量导入：配合__all__控制导出范围，避免泄漏B模块的内部变量

  from .B import *
  __all__ = ["func", "func2", "ClassA", "CONST_VAR"]
  

• 懒加载实现：首次调用时才加载B模块的对应对象，减少初始导入开销

  __all__ = ["func", "func2", "ClassA", "CONST_VAR"]
  def __getattr__(name):
      if name not in __all__:
          raise AttributeError(f"module 'A' has no attribute '{name}'")
      from . import B
      return getattr(B, name)
  

注意事项 #

• 如果你用的是顶级单文件模块（不是包内的子模块），不要使用相对导入，把from .B import改成from B import即可，否则会触发相对导入报错
• 如果原有业务逻辑中用到了A.__file__、A.__name__等模块元属性，需要根据需求做对应兼容，常规导入逻辑不受影响

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