Python同包相对导入跨目录运行报错原因及修复方案

这个报错和相对导入语法无关，核心原因是_buffer是C语言编写的扩展模块，不是随仓库源码直接提供的可直接导入的Python文件：

• 仓库src/aioquic路径下存放的_buffer.c是扩展源码、_buffer.pyi是类型提示存根，二者都不能被Python直接作为模块加载，只有编译后生成的.so（Linux/macOS）或.pyd（Windows）二进制文件才是可导入的_buffer模块。
• 从项目根目录运行示例程序不报错，是因为你大概率已经在当前Python环境执行过安装操作，编译生成的_buffer二进制文件已经被放到了环境的site-packages对应aioquic包路径下，Python导入时会优先加载环境中已安装的完整可用包，自然能找到C扩展。
• 当你进入src目录打开Python交互环境时，Python会自动把当前工作目录插入sys.path的最高优先级位置，此时导入aioquic会直接加载当前目录下的源码版本——这个目录里没有编译好的_buffer二进制文件，就会触发ModuleNotFoundError。
• from aioquic import about能正常执行，是因为about.py是纯Python文件，直接存在于源码目录中，不依赖C扩展，不受这个问题影响。
• 单纯修改PYTHONPATH指向src目录无法解决问题，这种方式只会让Python找到纯Python源码，依旧找不到未编译的C扩展模块。

根据使用场景选择对应方案即可，所有方案都能保证任意工作目录下导入逻辑正常：

• 开发场景推荐方案：在项目根目录执行可编辑模式安装，命令会自动完成C扩展编译，同时将源码路径正确注册到当前Python环境：

  pip install -e .
  

  安装完成后，无论你切换到哪个工作目录启动Python，导入aioquic时都会正确关联到编译好的C扩展，不会出现模块找不到的问题。
• 临时调试方案：如果不想做环境安装，只是临时在源码目录调试，可以在项目根目录执行命令将C扩展编译输出到源码目录：

  python setup.py build_ext --inplace
  

  编译完成后src/aioquic目录下会生成对应平台的_buffer二进制文件，此时在src目录下导入也能正常找到模块。
• Docker场景方案：在Dockerfile中增加安装步骤，不要直接拷贝源码后就切换工作目录运行，参考配置片段：

  COPY . /aioquic
  WORKDIR /aioquic
  RUN pip install -e .
  

  按该配置构建的镜像，无论容器内切换到哪个路径执行Python代码，导入逻辑都能正常生效。

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