跨盘符导入Python模块遇相对导入错误，求可行解决方案

问题根源 #

Python的相对导入（from ..xxx import ...）仅在模块被当作包的子模块加载时生效。当你从C盘的A.py导入Z盘fB目录下的B.py时，若仅把fB添加到sys.path，Python会将B.py识别为顶层模块而非某包的子模块，此时..无法找到对应的父包，从而抛出ImportError。单独运行B.py时，Python会自动识别其所在父目录为潜在包路径，但跨盘导入时该逻辑不生效。

最优方案（无需大量修改代码） #

1. 将Z盘的fB/fC共同父目录转为Python包 #

假设Z盘中fB和fC的共同父目录是Z:\my_project，按以下步骤操作：

• 在my_project目录下创建空的__init__.py文件（Python 3.3+可省略，但显式创建能避免兼容问题）。
• 把Z:\my_project加入Python搜索路径：
  • 临时方案：仅在A.py开头添加一次（比每个文件加sys.path.append更简洁）：

    import sys, os
    sys.path.append(r"Z:\my_project")
    

  • 永久方案：设置系统环境变量PYTHONPATH，将Z:\my_project添加进去，所有Python脚本都会自动识别该路径，无需修改代码。
• 修改A.py的导入语句为绝对导入：

  from my_project.fB.B import 你的函数名
  

• B.py中的相对导入可保留不变，此时Python会识别my_project为父包，..fC能正确指向同级的fC目录。

2. 改用绝对导入（无需创建__init__.py） #

若不想将父目录转为包，直接修改B.py的导入语句为绝对导入：

from fC.C import func

然后将Z:\my_project（fB/fC的父目录）加入sys.path或PYTHONPATH，这样不管是单独运行B.py还是从A.py导入，都能正确找到fC模块。

3. 用-m参数运行脚本（适合开发调试） #

开发阶段可用Python的-m参数以包模块的方式运行脚本：

• 单独运行B.py时，在命令行执行：

  python -m my_project.fB.B
  

• 运行A.py时，确保my_project在搜索路径中，直接正常运行即可，此时B.py会被当作包子模块加载，相对导入生效。

不推荐大量使用sys.path.append()的原因 #

这种方法会让代码耦合性极高，更换机器或路径就会报错，且维护难度大。上述方案均基于Python包导入机制设计，要么规范包结构，要么利用环境变量统一管理路径，可读性和可维护性更强。

内容的提问来源于stack exchange，提问作者Mats-Johan Fagerheim