Python同目录模块导入异常：Mod_b可访问Mod_1却无法访问Mod_2

文件夹结构 #

lib
|
|-MainScriptsDir
|      |
|      |-subDir
|        |
|        |- Mod_1 -> 导入Numpy 
|        |- Mod_2 -> 导入Mod_4 
|        |- Mod_3 -> 导入Mod_1、Mod_2
|        |- Mod_4
|
|-TestsDir
|   |
|   SubDirTests
|     |
|     |-Mod_a
|     |-Mod_b -> 导入Mod_3，可访问Mod_1的函数但无法访问Mod_2的函数
|

核心问题 #

导入Mod_3后，Mod_b能正常访问Mod_1的内容，但访问Mod_2时触发ImportError；在测试项目中则直接触发ModuleNotFoundError: No module named 'Mod_1'。修改Mod_3中Mod_2的导入语句为绝对路径后问题解决，需明确背后的原理。

导入细节 #

• Mod_b中导入方式：from lib.MainScriptsDir.SubDir.Mod_3 import *
• Mod_3原导入方式：from Mod_1 import * 和 from Mod_2 import *，Mod_3内部运行无异常
• 修复后Mod_3中Mod_2的导入：from lib.MainScriptsDir.SubDir.Mod_2 import *

原理分析 #

1. Python模块搜索路径机制 #

Python导入模块时，会从sys.path列表中的路径依次查找。当直接运行Mod_3时，当前工作目录（subDir）会被自动加入sys.path，所以from Mod_1 import *这类相对路径导入能正常工作。但当Mod_3被Mod_b导入时，sys.path的根目录是项目根目录（而非subDir），此时相对路径导入依赖的模块能否被找到，取决于subDir是否在sys.path中。

2. 实际环境与测试环境的差异 #

• 实际环境中，可能因IDE自动添加、其他模块导入时间接修改sys.path等原因，subDir被临时加入了sys.path，所以from Mod_1 import *能找到Mod_1，其内容被导入到Mod_3的命名空间，Mod_b因此能访问。但Mod_2内部导入Mod_4时，若Mod_2仍用相对路径from Mod_4 import *，此时若sys.path的上下文发生变化，就会找不到Mod_4，触发ImportError（因为Mod_2本身能被找到，但内部导入失败）。
• 测试环境中，sys.path未包含subDir，所以连Mod_1都找不到，直接触发ModuleNotFoundError。

3. 绝对路径导入的作用 #

将Mod_3中Mod_2的导入改为绝对路径from lib.MainScriptsDir.SubDir.Mod_2 import *后，Python会直接从项目根目录（已在sys.path中）开始查找模块，无需依赖subDir是否在sys.path中，从而避免了路径上下文的问题。若Mod_2内部也改用绝对路径导入Mod_4，就能彻底解决所有导入依赖问题。

关于__init__.py的补充 #

Python 3.3+支持无__init__.py的命名空间包，但为了明确包结构、避免导入歧义，建议在subDir、SubDirTests等文件夹下添加空的__init__.py文件，将其标记为正式的Python包。

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