Python3同目录导入自定义py文件触发基础ImportError如何排查修复？

常见成因 #

• 模块加载路径错误：Python解释器导入bill模块时，没有加载项目根目录下的bill.py，而是优先加载了其他路径下的同名模块/包（比如Python环境中预装的同名第三方包、其他工作目录下的同名bill.py文件），被加载的文件内没有定义Bill类，就会报这个导入错误。
• 代码结构错误：bill.py中的Bill类定义存在缩进问题，类被写在了函数、条件判断等代码块内部，不属于模块顶层可导出的对象，导入时无法识别。
• 拼写/大小写不匹配：类名、文件名存在大小写拼写误差，比如类实际定义为小写的bill、文件实际命名为大写开头的Bill.py，Python对标识符大小写严格敏感，会直接判定为找不到对应对象。
• 缓存/文件未保存问题：写完Bill类定义后没有保存bill.py文件到磁盘，或者项目目录下的__pycache__字节码缓存损坏，解释器读取到的是旧版本的文件内容。
• 导入写法不匹配：使用import bill导入模块后，没有通过bill.Bill的格式调用类，后续误写了不匹配的导入逻辑，或者导入语句位置错误。

对应解决方法 #

• 先确认模块加载路径是否正确，在main.py开头加入如下代码运行，查看输出的模块路径：

  import bill
  print(bill.__file__)
  

  如果输出路径不是你项目根目录下的bill.py，可以通过两种方式修复：要么将本地的bill.py重命名为不会和第三方库/标准库重名的名称（比如改成house_bill.py），要么在导入前手动将项目根目录加入Python导入路径的最优先级：

  import sys
  sys.path.insert(0, r"c:\Users\lavid\Desktop\Python Experimente\Python OOP Kurs\App-2-Flatmates-Bill")
  # 后续再写bill相关导入逻辑
  

• 检查bill.py的代码缩进，确认class Bill:这一行没有多余缩进，是处于文件最外层的顶层代码，没有被包裹在其他函数、if判断等代码块中。
• 逐字符核对文件名、类名、导入语句的拼写和大小写，确保文件名是小写的bill.py，类名是大写开头的Bill，导入语句的写法和实际定义完全一致。
• 关闭正在运行的Python进程，删除项目目录下的__pycache__文件夹，重新打开bill.py确认Bill类代码已经保存，再重新运行main.py。
• 统一导入写法：如果用import bill的导入方式，后续创建实例必须写bill.Bill()；如果想直接调用Bill类，就把导入语句改为from bill import Bill，不要混用写法漏写模块前缀。

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