同级目录新模块无法导入但旧模块正常，求排查思路

可能导致新模块导入失败的原因 #

• Python字节码缓存未更新
  Python会将编译后的模块存放在__pycache__文件夹中，新创建的C.py可能未生成对应缓存文件，而旧模块B.py的缓存早已存在。解决方法：删除SiblingB目录下的__pycache__文件夹，重新运行A.py。

• IDE文件索引未同步
  部分IDE（如PyCharm、VS Code）会缓存项目文件索引，新创建的C.py可能未被纳入索引范围，导致运行时无法识别。解决方法：手动刷新IDE的项目索引，或重启IDE后重试。

• 文件名大小写不匹配
  在Linux/macOS等区分文件名大小写的系统中，若实际文件名是c.py（小写），但导入代码写的是from SiblingB.C import ClassC，会因大小写不匹配报错。检查SiblingB目录下的文件名是否与导入语句完全一致。

• Python运行路径的动态问题
  可在A.py开头添加代码打印当前Python路径，确认root目录是否在sys.path中：

  import sys
  print(sys.path)
  

  若root不在路径中，旧模块能导入可能是之前运行时的路径残留（如曾以模块方式运行过python -m SiblingA.A，会自动将root加入路径），而新模块未触发路径更新。

• __init__.py的隐性缓存
  即便当前__init__.py是空的，若之前该文件有过导入逻辑（后被清空），可能残留了旧的模块结构缓存。可尝试在SiblingB/__init__.py中添加from . import C，显式声明模块，再重新导入。

旧模块可导入的异常点排查方向 #

• 运行方式的历史残留
  检查是否曾以模块方式运行过A.py（如python -m SiblingA.A），这种运行方式会自动将root目录加入sys.path；若后续改为直接运行python SiblingA/A.py，理论上sys.path仅包含SiblingA目录，但Python可能缓存了之前的模块信息，导致旧模块仍可被导入。

• 同名全局模块干扰
  检查Python全局环境中是否存在同名的SiblingB模块，可在A.py中添加代码查看模块实际路径：

  import SiblingB
  print(SiblingB.__file__)
  

  若输出路径不是你项目中的SiblingB目录，说明全局模块干扰了导入逻辑。

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