如何避免Python中因导入方式不同引发的重复模块导入陷阱？

通俗解释为什么会重复导入 #

Python里的模块导入是按导入路径的"全名"来识别模块的，你可以把每个模块看成一个带地址的仓库——哪怕两个地址指向同一个物理文件，只要地址写法不一样，Python就会当成两个完全独立的仓库，各自重新执行一遍模块代码，里面的全局变量（比如你的ConnectionManager实例）自然就会被创建两次。

比如你遇到的情况：websocket.ws和app.websocket.ws这两个导入路径，在Python眼里是两个不同的模块名，所以它会分别加载两次这个文件，生成两个独立的模块对象，每个对象里都有自己的ConnectionManager实例。哪怕没有循环导入，只要导入路径不统一，就会触发这个问题。

避免重复实例的最佳实践 #

• 统一项目内的导入风格：整个项目里只用一种方式导入同一个模块。比如要么全用从项目根出发的绝对导入（比如from app.websocket import ws），要么在子模块里用相对导入（比如from . import ws），绝对不要混着用不同的全路径导入同一个文件。
• 把项目根加入Python路径：运行代码前，确保项目根目录在sys.path里。可以在启动脚本开头加import sys, os; sys.path.insert(0, os.path.abspath(os.path.dirname(__file__)))，或者用pip install -e .把项目安装成可编辑包，这样所有导入都会基于顶级包名，不会出现路径歧义。
• 不要在模块级别直接创建全局实例：如果需要单例的ConnectionManager，别直接在模块里写manager = ConnectionManager()。改成用单例模式实现，比如给类加一个get_instance类方法：

  class ConnectionManager:
      _instance = None
      @classmethod
      def get_instance(cls):
          if cls._instance is None:
              cls._instance = cls()
          return cls._instance
  

  然后所有地方都调用ConnectionManager.get_instance()来获取实例，不管模块被导入多少次，都只会生成一个实例。
• 排查导入问题的小技巧：怀疑模块被重复导入时，在模块里加print(__name__, __file__)，运行后看输出的模块名和文件路径，如果同一个文件出现不同的模块名，就说明是导入路径不统一导致的。

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