Python开发带公司命名空间依赖的包如何避免命名空间冲突（PEP423）

以下是几个无需使用相对导入的可行解决方案：

1. 用可编辑安装关联本地开发包 #

在你开发的acme-webcrawler包根目录（包含setup.py或pyproject.toml的目录）执行：

pip install -e .

这会在Python的site-packages中创建一个指向本地项目的链接，Python会自动合并site-packages中已安装的acme命名空间包和本地开发的acme.webcrawler子包，不会出现本地目录覆盖已安装包的情况。

2. 调整PyCharm的项目源码根配置 #

• 打开File > Project Structure
• 在Modules标签下，找到本地项目中的acme目录，将其标记为Sources Root（不要把上级的pythonprojects目录设为源码根）
• 检查Python解释器配置，确保已安装的acme-request-utils包在解释器的依赖列表中
  这样PyCharm会优先从site-packages加载已有的acme.request_utils，再从本地源码根加载当前开发的子包，避免路径冲突。

3. 采用PEP 420无__init__.py的命名空间包规范 #

删除本地acme目录下的__init__.py文件（如果有的话）。PEP 420允许无__init__.py的目录作为命名空间包，Python会自动合并所有搜索路径下同名命名空间目录中的子包，本地的acme目录和site-packages中的acme目录会被合并，自然就能正常导入acme.request_utils。
如果需要兼容Python 3.3之前的版本，可以保留空的__init__.py，但不要在其中添加任何会干扰命名空间的代码。

4. 调整本地项目目录结构 #

把你的acme-webcrawler项目结构改为：

pythonprojects/
└── acme-webcrawler/
    ├── acme/
    │   └── webcrawler/
    │       ├── __init__.py
    │       └── crawler.py
    └── setup.py

而非直接把acme放在pythonprojects目录下。这样本地的acme目录仅属于当前项目，不会和其他项目或site-packages中的acme目录产生路径冲突。

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