如何基于指定路径列表手动创建Python命名空间包，并在存在同名包时优先导入目标命名空间包

嘿，我之前也踩过这个同名包shadow命名空间的坑，太懂这种明明自己的包在那儿却导不进来的憋屈了！结合PEP420的规则和Python的导入底层逻辑，给你两个完全符合需求的解决方案——全程不用改/path/xxx的任何内容：

一、强制导入你的目标命名空间包（彻底绕过同名普通包） #

因为PEP420明确规定普通包（带__init__.py或单独py文件的）优先级比命名空间包高，哪怕你把目标路径塞到sys.path最前面，Python还是会优先选普通包。所以我们得直接跳过它的默认搜索流程，手动把自己的命名空间包塞进模块缓存里：

具体代码 #

import sys
import importlib.util

def force_import_namespace(package_name, target_paths):
    # 先清掉缓存里的同名模块，避免和已导入的普通包冲突
    if package_name in sys.modules:
        del sys.modules[package_name]
    
    # 手动构造命名空间包的spec（完全符合PEP420规范）
    # 命名空间包的核心就是：没有loader，origin为None，路径存在submodule_search_locations里
    spec = importlib.util.spec_from_loader(
        package_name,
        None,
        origin=None,
        submodule_search_locations=target_paths
    )
    # 从spec生成模块对象
    ns_package = importlib.util.module_from_spec(spec)
    # 把模块塞进缓存，后续import直接用这个，不会再去搜sys.path
    sys.modules[package_name] = ns_package
    # 初始化模块（对命名空间包来说这步只是走个流程，不影响功能）
    spec.loader.exec_module(ns_package)
    return ns_package

# 调用函数导入你的/path/xxx
my_xxx = force_import_namespace('xxx', ['/path/xxx'])

# 现在不管有没有同名普通包，import xxx都会拿到你要的命名空间包
import xxx
print(xxx.__path__)  # 输出: ['/path/xxx']

为什么这招管用？ #

Python导入模块的第一步是查sys.modules缓存，我们直接把自己构造的命名空间包塞进去，就完全跳过了它的路径搜索流程——不管sys.path里有多少同名普通包，都不会被搜到了。

二、从任意路径列表手动创建命名空间包 #

如果你需要把多个路径下的同名文件夹合并成一个命名空间包（比如/path1/xxx和/path2/xxx），直接给上面的函数传路径列表就行，和Python自动生成的命名空间包行为完全一致：

示例：合并两个路径成一个命名空间包 #

# 把两个路径下的xxx合并成一个命名空间包
combined_xxx = force_import_namespace('xxx', ['/path1/xxx', '/path2/xxx'])
print(combined_xxx.__path__)  # 输出: ['/path1/xxx', '/path2/xxx']

# 之后导入子模块时，会自动在这两个路径里依次搜索
from xxx import submodule  # 先找/path1/xxx/submodule，再找/path2/xxx/submodule

额外实用小技巧 #

1. 动态加路径：如果之后要给命名空间包新增路径，直接修改__path__就行：

   xxx.__path__.append('/new/path/xxx')
   

2. 验证是否成功：导入后可以打印xxx.__file__，命名空间包的__file__是None，而普通包会显示它的__init__.py路径，一眼就能确认是不是你要的那个。
3. 避免重复创建：如果你的代码可能多次执行这个导入逻辑，记得每次都先检查sys.modules里的同名模块，确保先删掉再创建。

为什么你之前搜importlib没找到？ #

因为这个操作比较小众，官方文档里没有专门的“创建命名空间包”API，但只要抓住PEP420的本质——命名空间包就是没有loader、路径存在__path__里的模块——用importlib的底层spec机制就能轻松实现啦。

备注：内容来源于stack exchange，提问作者John Ao