能否将Python嵌套子包别名到顶层包，支持点标记法访问？

解决方案 #

要实现mypackage.target_package直接指向mypackage.subpackage.target_package，同时兼容原有导入方式，只需修改两个__init__.py文件：

1. 修改顶层mypackage/__init__.py：

import sys
from .subpackage import target_package

# 将嵌套子包映射到顶层命名空间
sys.modules['mypackage.target_package'] = target_package

2. 修改mypackage/subpackage/__init__.py：

from . import target_package

完成后，不管是import mypackage.target_package还是from mypackage import target_package都能正常工作，原有代码的访问逻辑完全不受影响。

为什么之前的方法不行？ #

你之前只在顶层__init__.py里导入了target_package，这仅能让from mypackage import target_package生效，但import mypackage.target_package会要求Python在mypackage目录下找到名为target_package的子目录或模块文件。通过sys.modules手动注册模块映射，就能告诉Python：当请求mypackage.target_package时，直接返回已导入的mypackage.subpackage.target_package对象。

最佳实践建议 #

• 这种别名方式完全可行，也不违反Python包的最佳实践，不少成熟项目（如requests、numpy）都会用这种方式维护向后兼容性。
• 建议在项目文档中明确标注该别名是兼容旧版本的过渡方案，引导用户逐步迁移到mypackage.subpackage.target_package的新路径，避免长期依赖别名导致命名空间混乱。
• 如果后续计划移除这个兼容路径，可以在导入时添加警告提示：

  import warnings
  warnings.warn(
      "mypackage.target_package已迁移至mypackage.subpackage.target_package，后续版本将移除该别名",
      DeprecationWarning,
      stacklevel=2
  )
  

• 除非有特殊需求，不要过度使用这种别名，保持包结构的清晰性始终是优先原则。

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