Python无法导入二级子目录模块，请求排查问题原因

问题背景 #

重构代码提升可读性时，遇到模块导入异常：一级子目录模块可正常导入，但二级子目录模块无法识别。

项目目录结构 #

src
  managements  
    __init__.py  
    azureManagement.py  
    azuredevops  
      __init__.py  
      coreManagement.py  
  main.py  

核心代码（main.py） #

from managements.azureManagement import Management as Azure
from managements.azuredevops.coreManagement import Management as AzureDevOpsCore
...

报错信息 #

No module named 'managements.azuredevops.coreManagement'

排查方向及解决方案 #

• 检查二级子目录的__init__.py：managements/azuredevops/__init__.py若存在错误语句（比如错误的导入、变量覆盖），会干扰模块识别。先清空该文件，验证是否能正常导入。
• 核对名称大小写：Linux/macOS系统对文件路径大小写敏感，需确保代码中写的azuredevops、coreManagement.py和实际文件目录、文件名的大小写完全一致（Windows系统无此问题，但建议统一规范）。
• 验证Python运行路径：运行main.py时，Python需要将src目录纳入模块搜索路径。可在main.py开头添加代码检查：

  import sys
  print(sys.path)
  

  若src的父路径不在输出列表中，添加以下代码修正：

  import sys
  from pathlib import Path
  sys.path.append(str(Path(__file__).parent))
  

• 规范模块命名（可选）：遵循PEP8规范将模块名改为小写加下划线格式（如core_management.py），避免因命名风格引发的隐性问题。

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