Python命名空间冲突：本地源码与已安装模块导入优先级问题

针对你遇到的本地mynamespace.subpackage_b无法导入、只能使用site-packages中mynamespace.subpackage_a的问题，可通过以下几种方式解决：

1. 精准配置pyproject.toml的packages字段 #

修改pyproject.toml中的packages配置，只包含本地开发的subpackage_b模块，而非整个mynamespace命名空间，避免与site-packages中的命名空间目录冲突：

[tool.poetry]
name = "mynamespace-subpackage-b"
version = "1.0.0"
description = ""
authors = ["author"]
packages = [
  {include = "mynamespace/subpackage_b", from = "."}
]

这样Poetry处理本地开发环境时，只会将mynamespace/subpackage_b加入Python路径，不会覆盖或干扰site-packages中已存在的mynamespace目录。

2. 以可编辑模式安装本地包 #

在subpackage_b的项目根目录下执行以下命令，将本地源码以可编辑模式安装到虚拟环境：

poetry install --editable .

该命令会让Python优先加载本地的subpackage_b源码，同时保留site-packages中已安装的subpackage_a依赖，实现两者同时导入。

3. 调整PYTHONPATH优先级 #

将subpackage_b项目的根目录添加到PYTHONPATH最前端，确保Python优先搜索本地源码：

export PYTHONPATH="/path/to/subpackage_b_root:$PYTHONPATH"

若要永久生效，可将该命令添加到Poetry虚拟环境的激活脚本中（如venv/bin/activate），每次激活虚拟环境时自动配置。

原理说明：PEP420命名空间包依赖无__init__.py的同名目录实现多包合并，但Python会优先搜索site-packages目录。通过上述方法，要么缩小本地包的暴露范围，要么提升本地路径的搜索优先级，从而解决命名空间冲突问题。

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