拆分Python工厂方法到多模块时遇ImportError问题求助

哎呀，这个导入错误我太熟了！拆分单文件代码到多模块时很容易踩这些坑，我帮你一步步分析原因和解决办法：

常见原因及对应解决办法 #

1. 循环导入（最常见的坑） #

假设你的main.py里有工厂类，而circle.py又试图导入main.py里的东西（比如工厂类或者其他依赖），就会出现循环依赖，Python解析器会直接懵圈，找不到Circle类。

错误场景示例：

• main.py代码：

  from circle import Circle
  from square import Square
  
  class ShapeFactory:
      def create_shape(self, shape_type):
          if shape_type == "circle":
              return Circle()
          elif shape_type == "square":
              return Square()
  

• circle.py错误导入了main里的工厂：

  from main import ShapeFactory
  
  class Circle:
      def draw(self):
          print("Drawing a circle")
  

这时候运行main.py就会触发循环导入，直接抛出找不到Circle的错误。

解决办法：
把工厂类单独抽出来放到新模块（比如shape_factory.py）里，彻底避免循环：

• 新建shape_factory.py：

  from circle import Circle
  from square import Square
  
  class ShapeFactory:
      def create_shape(self, shape_type):
          if shape_type == "circle":
              return Circle()
          elif shape_type == "square":
              return Square()
  

• main.py改为：

  from shape_factory import ShapeFactory
  
  if __name__ == "__main__":
      factory = ShapeFactory()
      circle = factory.create_shape("circle")
      circle.draw()
  

• circle.py只负责定义类，不导入main里的任何内容：

  class Circle:
      def draw(self):
          print("Drawing a circle")
  

2. 导入语句或类名/文件名拼写错误 #

这个看起来低级但真的很容易犯：

• 比如circle.py里的类名是小写的circle，但你在main.py里写了from circle import Circle（大写）；
• 或者文件名是Circle.py（首字母大写），但你导入的是from circle import Circle（小写文件名）——Windows下可能没问题，但Linux/macOS是大小写敏感的，直接报错；
• 还有可能导入路径写错，比如模块在子文件夹里，没加相对导入或者没把路径加入sys.path。

解决办法：

• 严格检查文件名和类名的大小写，保持完全一致；
• 如果是子文件夹结构（比如shapes/circle.py），要使用正确的导入路径：from shapes.circle import Circle，同时确保shapes文件夹里有__init__.py（Python 3.3+可以省略，但加上更规范）。

3. Python找不到你的模块（路径问题） #

如果你运行main.py的目录不是项目根目录，Python会找不到circle.py和square.py。比如你的项目在~/code/shape_project/，但你在~/code/目录下运行python shape_project/main.py，这时候Python的模块搜索路径里没有shape_project，自然找不到circle模块。

解决办法：

• 切换到项目根目录再运行：cd ~/code/shape_project && python main.py；
• 或者在main.py开头手动添加项目路径到sys.path：

  import sys
  import os
  sys.path.append(os.path.dirname(os.path.abspath(__file__)))
  
  from circle import Circle
  # 后续代码...
  

4. Circle类定义有问题（缩进错误或嵌套） #

如果circle.py里的Circle类缩进错了，或者被定义在某个函数/类内部，那么从外部导入时就找不到这个类。

错误示例：

def some_function():
    class Circle:
        def draw(self):
            print("Drawing a circle")

这时候Circle是函数内部的类，外部根本无法导入。

解决办法：
确保Circle类是在circle.py的顶层作用域定义的，没有被嵌套在任何函数或类里面：

# circle.py 正确写法
class Circle:
    def draw(self):
        print("Drawing a circle")

验证正确的项目结构和代码 #

最后给你一个能正常运行的完整示例，你可以对照自己的代码调整：

项目结构：

shape_project/
├── main.py
├── circle.py
├── square.py
└── shape_factory.py  # 避免循环导入的最佳实践

circle.py：

class Circle:
    def draw(self):
        print("Drawing a circle")

square.py：

class Square:
    def draw(self):
        print("Drawing a square")

shape_factory.py：

from circle import Circle
from square import Square

class ShapeFactory:
    def create_shape(self, shape_type):
        shape_type = shape_type.lower()
        if shape_type == "circle":
            return Circle()
        elif shape_type == "square":
            return Square()
        else:
            raise ValueError(f"Unknown shape type: {shape_type}")

main.py：

from shape_factory import ShapeFactory

if __name__ == "__main__":
    factory = ShapeFactory()
    
    circle = factory.create_shape("circle")
    circle.draw()
    
    square = factory.create_shape("square")
    square.draw()

运行main.py就能正常输出啦！

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