如何实现类C++ namespace的单文件命名树扩展？Python子包导入疑问

1. Python中模拟C++单文件内嵌套命名空间的方法 #

Python没有像C++那样原生的namespace关键字，但可以通过两种常用方式在单个文件内实现类似的嵌套命名树效果：

• 方式一：使用嵌套类
  利用类本身的命名空间特性，通过嵌套类层级模拟C++的命名空间结构：

  # 单个.py文件内的代码
  class MilkyWay:
      class AlphaCentauri:
          Planets = 4
      class SolarSys:
          Planets = 8
  
  # 访问方式
  print(MilkyWay.SolarSys.Planets)  # 输出8
  

• 方式二：使用types.SimpleNamespace创建轻量命名空间
  借助标准库的SimpleNamespace，可以创建无逻辑的纯命名空间对象，比嵌套类更简洁：

  import types
  
  # 顶层命名空间
  MilkyWay = types.SimpleNamespace()
  # 添加子命名空间
  MilkyWay.AlphaCentauri = types.SimpleNamespace(Planets=4)
  MilkyWay.SolarSys = types.SimpleNamespace(Planets=8)
  
  # 访问方式
  print(MilkyWay.SolarSys.Planets)  # 输出8
  

2. 为什么from sound import formats无法执行？ #

核心原因是：Python顶层包不会自动将子包暴露为自身的属性。

• 当执行from sound.formats import wavread时，Python会直接遍历文件系统找到sound/formats目录（因目录下存在__init__.py，被识别为合法子包），直接导入其中的wavread模块，这个过程不需要顶层sound/__init__.py做任何配置。
• 而from sound import formats要求formats是sound模块的一个属性，但默认情况下，顶层包的__init__.py并没有导入子包formats，所以Python无法识别formats属于sound的成员。

解决方法很简单：在sound/__init__.py中添加一行导入语句，将子包注册为顶层包的属性：

# sound/__init__.py
from . import formats

或者：

# sound/__init__.py
import sound.formats as formats

添加后即可正常执行from sound import formats。

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